Previous

Next

Function RTUSetClientData

RTUSetClientData associates client-private data with a claimed interface of a device:

void RTUSetClientData(RTUDeviceHandle    Device, 
                      RTUConnectCallback ClientCallback, 
                      const void       * Data);

Parameters

Device

Device handle passed to an attachment/detachment callback.

ClientCallback

Address of the client's attachment/detachment callback. This value must have been supplied to RTUClaimInterface before it is used with this function. The same value can be used with RTUGetClientData to retrieve the Data.

Data

Pointer to the data to associate with the device for the client. This pointer can later be retrieved with RTUGetClientData.

The client data will usually be a dynamically allocated structure the client needs to manage a device's interface. It is the client's responsibility to deallocate this data when the device is detached.

The client must have called RTUClaimInterface successfully before this function is called. Failing to do so aborts the program with a fatal error.

Function RTUCallOnDisconnect

Function RTUGetClientData