CDI_Bind_CDM_To_Object
Binds a CDM to a device and registers with NWPA the
I/O and control functions that the CDM supports for the
device.
- Thread Context:Blocking
Syntax
LONG CDI_Bind_CDM_To_Object (
LONG cdmOSHandle,
LONG npaDeviceID,
LONG cdmBindHandle,
LONG *cdiBindHandle,
struct UpdateInfoStruct *info,
LONG infoSize);
Parameters
- cdmOSHandle
- (IN) The CDM's handle for using the CDI APIs. The
value of cdmOSHandle was assigned during CDI_Register_CDM, and it is used
in conjunction with the CDM-generated Handle to
uniquely identify a CDM when it interfaces with NWPA through the
CDI API set.
- npaDeviceID
- (IN) The object ID that NWPA assigned to the target
device in its device database. This value is passed to the CDM through
its CDM_Inquiry entry point.
- cdmBindHandle
- (IN) A value that uniquely identifies the device
object that is being bound. The CDM must be able to map the object's
device information from this value.
- cdiBindHandle
- (OUT) Receives an NWPA-generated handle for the
target device to which the CDM is binding. This handle is NWPA's
counterpart to the CDM's cdmBindHandle.
- info
- (IN) Points to an UpdateInfoStruct. This structure contains the information
telling NWPA what functions the CDM supports for the device.
- infoSize
- (IN) The size of the UpdateInfoStruct pointed at by info.
Return Values
The following table lists return values and descriptions.
Remarks
This function is used to bind a device object to a CDM. This
routine is used within the context of CDM_Inquiry.