CONFIGMG_Query_Change_Config

CONFIGRET CONFIGMG_Query_Change_Config(ULONG ulDock, ULONG ulSerialNo, ULONG ulFlags)
 

Determine if it is okay to change the current Hardware Profile.

ulDock
The Docking Station Identifier of the dock that the computer is attempting to connect to, 0 if unknown or if this is a request to undock.
ulSerialNo
The Docking Station Serial Number of the dock that the computer is attempting to connect to, 0 if unknown or if this is a request to undock.
ulFlags
Must be one of the following.
CM_HW_PROF_UNDOCK The computer is attempting to undock.
CM_HW_PROF_DOCK The computer is attempting to dock to an unidentified dock.
CM_HW_PROF_DOCK_KNOWN The computer is attempting to dock to a known dock, which is identified by the ulDock and ulSerialNo paramters.

This function should only be called by a Plug and Play BIOS Enumerator. This function leaves some Root enumerated devnodes in an inactive state. After calling this function either CONFIGMG_Recompute_HW_Prof or CM_Fail_Change_HW_Prof must be called to return the Root enumerated devnodes to a normal state.

See Also

CONFIGMG_Recompute_HW_Prof