CDI_Unbind_CDM_From_Object

Unbinds a CDM from a device object.

Thread Context:Blocking

Syntax

    LONG CDI_Unbind_CDM_From_Object (
       LONG   cdmOSHandle,
       LONG   cdiBindHandle
       );

Parameters

cmdOSHandle
(IN) 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.
cdiBindHandle
(IN) The NWPA-generated bind handle that was assigned to the calling CDM when it bound to the target device using CDI_Bind_CDM_To_Object.

Return Values

The following table lists return values and descriptions.

zero

Successful

nonzero

Unsuccessful

Remarks

CDI_Unbind_CDM_From_Object is used by the CDM to unbind itself from a device. When a CDM is unbound, it no longer has to handle requests for that device. Typically, the CDM calls this function at unload time within the context of CDM_Unload. However, if the CDM determines that it should no longer support a device, it can call CDI_Unbind_CDM_From_Object, and it no longer needs to handle requests for that device.