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.