ConfigHandler

CONFIGRET ConfigHandler(CONFIGFUNC cfFunc, 
    SUBCONFIGFUNC scfSubFunc, DEVNODE dnDevNode, 
    DWORD dwRefData, ULONG ulFlags);
 

A driver-supplied function that processes configuration messages for a device node.

• Returns CR_SUCCESS if successful, or one of the error values given in Constants.

cfFunc

Function identifier. Can be one of these values.

CONFIG_APM	APM functions.
CONFIG_CALLBACK	Devnode is being called back.
CONFIG_ENUMERATE	Devnode must enumerated.
CONFIG_FILTER	Ancestors must filter requirements.
CONFIG_PREREMOVE	Devnode must stop using config.
CONFIG_PREREMOVE2	Devnode must stop using config.
CONFIG_READY	The devnode has been setup.
CONFIG_REMOVE	Devnode must stop using config.
CONFIG_SETUP	Devnode should download driver.
CONFIG_SHUTDOWN	We are shutting down.
CONFIG_START	Devnode dynamic initialization.
CONFIG_STOP	Devnode must stop using config.
CONFIG_TEST	Can devnode change state now.
CONFIG_TEST_FAILED	Continue as before after a TEST.
CONFIG_TEST_SUCCEEDED	Prepare for the STOP/REMOVE.
CONFIG_VERIFY_DEVICE	Insure the legacy card is there.

scfSubFunc

Subfunction identifier.

dnDevNode

Handle of the device node to process messages for.

dwRefData

32-bit reference data value. This is the 32-bit value passed to the CONFIGMG_Register_Device_Driver service when the handler was registered.

ulFlags

Reserved; must be 0.