CDI_Return_Object_Info

Allows a CDM to read the current information of a device object.

Thread Context:Non-Blocking

Syntax

    LONG CDI_Return_Object_Info (
       LONG                     npaDeviceID,
       struct UpdateInfoStruct *info
       );

Parameters

npaDeviceID
(IN) The npaDeviceID passed to the CDM within its CDM_Inquiry function. It also corresponds to the Media Manager object ID for the device.
info
(IN) The CDM provides the address to an UpdateInfoStruct. NWPA will fill out the structure with the current information about the device.

Return Values

The following table lists return values and descriptions.

zero

Successful

nonzero

Unsuccessful

Remarks

CDI_Return_Object_Info is used to return the current state of a device. It is required if a CDM is binding to a new device that was already bound to another CDM. In this way, it can inherit the old CDM's settings, and modify what is necessary when binding and taking control of the device.