CONFIGMG_Register_Enumerator

CONFIGRET CONFIGMG_Register_Enumerator(DEVNODE dnDevNode, CMENUMHANDLER Handler, ULONG ulFlags)
 

Registers the enumerator handler for a device node.

• Returns CR_SUCCESS if the function is successful. Otherwise, the return value can be CR_INVALID_API, CR_INVALID_DEVNODE or CR_INVALID_FLAG.

dnDevNode

Handle of a device node. This handle must have been created by a call to the CONFIGMG_Locate_DevNode or CONFIGMG_Create_DevNode function.

Handler

Enumerator entry point. This is the routine that will handle all enumerator calls. If this parameter is NULL, no enumerator is loaded.

ulFlags

CM_REGISTER_ENUMERATOR_HARDWARE iff the enumerator does hardware detection (ie know for sure the device is there or not. Otherwise, must be CM_REGISTER_ENUMERATOR_SOFWARE.

This function must be called whenever a device driver needs to be the enumerator for a device. This function should be called near the end of the initialization of an enumerator.

The Handler parameter is NULL when the device cannot be enumerated (as with VPICD, for example).

See Also

CONFIGMG_Create_DevNode, CONFIGMG_Locate_DevNode