udi_channel_set_context(3udi)


Attach a new context to a channel endpoint

SYNOPSIS

#include <udi.h>

void udi_channel_set_context (

	udi_channel_t target_channel,

	void *channel_context );
 

ARGUMENTS target_channel is a channel handle for the channel endpoint to be modified.

channel_context is a generic pointer that will be returned as-is by UDI in any channel operations related to this channel.

DESCRIPTION udi_channel_set_context attaches a new context pointer to the local end of a target channel. The new context pointer will be attached to the referenced channel (target_channel) by the time this call returns. It will then be passed to the driver with each channel operation in the gcb.channel_context member of the control block.

WARNINGS udi_channel_set_context must be called from the region containing the channel endpoint. This endpoint must already be anchored.


UDI Core Specification Contents