CONFIGMG_Register_Device_Driver

CONFIGRET CONFIGMG_Register_Device_Driver(DEVNODE dnDevNode, CMCONFIGHANDLER Handler, ULONG ulRefData, ULONG ulFlags)

Registers a configuration handler for a device node.

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

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

Device-driver entry point. This is the routine that will handle all device-driver configuration functions. This parameter can be NULL if the device driver does not need to monitor configuration events.

ulRefData

Data that will be passed back to the Handler.

ulFlags

Must be either CM_REGISTER_DEVICE_DRIVER_STATIC or a combination of CM_REGISTER_DEVICE_DRIVER_DISABLEABLE and/or CM_REGISTER_DEVICE_DRIVER_REMOVABLE.

This function must be called by any Plug and Play device that owns a device node. It should be called only when the initializing device driver is ready to start handling the device. Note that this API can be called from ring 3 but the handler needs to be NULL in that case.

See also CONFIGMG_Create_DevNode, CONFIGMG_Locate_DevNode