cfgmgr32.h header

This header is used by Device and Driver Installation Reference. For more information, see:

Functions

Title Description
CM_Add_Empty_Log_Conf The CM_Add_Empty_Log_Conf function creates an empty logical configuration, for a specified configuration type and a specified device instance, on the local machine.
CM_Add_Empty_Log_Conf_Ex The CM_Add_Empty_Log_Conf_Ex function creates an empty logical configuration, for a specified configuration type and a specified device instance, on either the local or a remote machine.
CM_Add_ID_ExW The CM_Add_ID_Ex function appends a device ID (if not already present) to a device instance's hardware ID list or compatible ID list, on either the local or a remote machine.
CM_Add_IDW The CM_Add_ID function appends a specified device ID (if not already present) to a device instance's�hardware ID list or compatible ID list.
CM_Add_Res_Des The CM_Add_Res_Des function adds a resource descriptor to a logical configuration.
CM_Add_Res_Des_Ex The CM_Add_Res_Des_Ex function adds a resource descriptor to a logical configuration. The logical configuration can be on either the local or a remote machine.
CM_Connect_MachineW The CM_Connect_Machine function creates a connection to a remote machine.
CM_Delete_Class_Key The CM_Delete_Class_Key function removes the specified installed device class from the system.
CM_Delete_Device_Interface_Key_ExA The CM_Delete_Device_Interface_Key_ExA function deletes the registry subkey that is used by applications and drivers to store interface-specific information.
CM_Delete_Device_Interface_Key_ExW The CM_Delete_Device_Interface_Key_ExW function deletes the registry subkey that is used by applications and drivers to store interface-specific information.
CM_Delete_Device_Interface_KeyW The CM_Delete_Device_Interface_Key function deletes the registry subkey that is used by applications and drivers to store interface-specific information.
CM_Delete_DevNode_Key The CM_Delete_DevNode_Key function deletes the specified user-accessible registry keys that are associated with a device.
CM_Disable_DevNode The CM_Disable_DevNode function disables a device.
CM_Disconnect_Machine The CM_Disconnect_Machine function removes a connection to a remote machine.
CM_Enable_DevNode The CM_Enable_DevNode function enables a device.
CM_Enumerate_Classes The CM_Enumerate_Classes function, when called repeatedly, enumerates the local machine's installed device classes by supplying each class's GUID.
CM_Enumerate_Classes_Ex The CM_Enumerate_Classes_Ex function, when called repeatedly, enumerates a local or a remote machine's installed device classes, by supplying each class's GUID.
CM_Enumerate_Enumerators_ExW The CM_Enumerate_Enumerators_Ex function enumerates a local or a remote machine's device enumerators, by supplying each enumerator's name.
CM_Enumerate_EnumeratorsW The CM_Enumerate_Enumerators function enumerates the local machine's device enumerators by supplying each enumerator's name.
CM_Free_Log_Conf The CM_Free_Log_Conf function removes a logical configuration and all associated resource descriptors from the local machine.
CM_Free_Log_Conf_Ex The CM_Free_Log_Conf_Ex function removes a logical configuration and all associated resource descriptors from either a local or a remote machine.
CM_Free_Log_Conf_Handle The CM_Free_Log_Conf_Handle function invalidates a logical configuration handle and frees its associated memory allocation.
CM_Free_Res_Des The CM_Free_Res_Des function removes a resource descriptor from a logical configuration on the local machine.
CM_Free_Res_Des_Ex The CM_Free_Res_Des_Ex function removes a resource descriptor from a logical configuration on either a local or a remote machine.
CM_Free_Res_Des_Handle The CM_Free_Res_Des_Handle function invalidates a resource description handle and frees its associated memory allocation.
CM_Free_Resource_Conflict_Handle The CM_Free_Resource_Conflict_Handle function invalidates a handle to a resource conflict list, and frees the handle's associated memory allocation.
CM_Get_Child The CM_Get_Child function is used to retrieve a device instance handle to the first child node of a specified device node (devnode) in the local machine's device tree.
CM_Get_Child_Ex The CM_Get_Child_Ex function is used to retrieve a device instance handle to the first child node of a specified device node (devnode) in a local or a remote machine's device tree.
CM_Get_Class_Property_ExW The CM_Get_Class_Property_ExW function retrieves a device property that is set for a device interface class or device setup class.
CM_Get_Class_Property_Keys The CM_Get_Class_Property_Keys function retrieves an array of the device property keys that represent the device properties that are set for a device interface class or device setup class.
CM_Get_Class_Property_Keys_Ex The CM_Get_Class_Property_Keys_Ex function retrieves an array of the device property keys that represent the device properties that are set for a device interface class or device setup class.
CM_Get_Class_PropertyW The CM_Get_Class_Property function retrieves a device property that is set for a device interface class or device setup class.
CM_Get_Class_Registry_PropertyW The CM_Get_Class_Registry_Property function retrieves a device setup class property.
CM_Get_Depth The CM_Get_Depth function is used to obtain the depth of a specified device node (devnode) within the local machine's device tree.
CM_Get_Depth_Ex The CM_Get_Depth_Ex function is used to obtain the depth of a specified device node (devnode) within a local or a remote machine's device tree.
CM_Get_Device_ID_ExW The CM_Get_Device_ID_Ex function retrieves the device instance ID for a specified device instance on a local or a remote machine.
CM_Get_Device_ID_List_ExW The CM_Get_Device_ID_List_Ex function retrieves a list of device instance IDs for the device instances on a local or a remote machine.
CM_Get_Device_ID_List_Size_ExW The CM_Get_Device_ID_List_Size_Ex function retrieves the buffer size required to hold a list of device instance IDs for a local or a remote machine's device instances.
CM_Get_Device_ID_List_SizeA The CM_Get_Device_ID_List_Size function retrieves the buffer size required to hold a list of device instance IDs for the local machine's device instances.
CM_Get_Device_ID_List_SizeW The CM_Get_Device_ID_List_Size function retrieves the buffer size required to hold a list of device instance IDs for the local machine's device instances.
CM_Get_Device_ID_ListA The CM_Get_Device_ID_List function retrieves a list of device instance IDs for the local computer's device instances.
CM_Get_Device_ID_ListW The CM_Get_Device_ID_List function retrieves a list of device instance IDs for the local computer's device instances.
CM_Get_Device_ID_Size The CM_Get_Device_ID_Size function retrieves the buffer size required to hold a device instance ID for a device instance on the local machine.
CM_Get_Device_ID_Size_Ex The CM_Get_Device_ID_Size_Ex function retrieves the buffer size required to hold a device instance ID for a device instance on a local or a remote machine.
CM_Get_Device_IDW The CM_Get_Device_ID function retrieves the device instance ID for a specified device instance on the local machine.
CM_Get_Device_Interface_AliasW The CM_Get_Device_Interface_Alias function returns the alias of the specified device interface instance, if the alias exists.
CM_Get_Device_Interface_List_SizeA The CM_Get_Device_Interface_List_Size function retrieves the buffer size that must be passed to the CM_Get_Device_Interface_List function.
CM_Get_Device_Interface_List_SizeW The CM_Get_Device_Interface_List_Size function retrieves the buffer size that must be passed to the CM_Get_Device_Interface_List function.
CM_Get_Device_Interface_ListA The CM_Get_Device_Interface_List function retrieves a list of device interface instances that belong to a specified device interface class.
CM_Get_Device_Interface_ListW The CM_Get_Device_Interface_List function retrieves a list of device interface instances that belong to a specified device interface class.
CM_Get_Device_Interface_Property_ExW The CM_Get_Device_Interface_Property_ExW function retrieves a device property that is set for a device interface.
CM_Get_Device_Interface_Property_Keys_ExW The CM_Get_Device_Interface_Property_Keys_ExW function retrieves an array of device property keys that represent the device properties that are set for a device interface.
CM_Get_Device_Interface_Property_KeysW The CM_Get_Device_Interface_Property_Keys function retrieves an array of device property keys that represent the device properties that are set for a device interface.
CM_Get_Device_Interface_PropertyW The CM_Get_Device_Interface_Property function retrieves a device property that is set for a device interface.
CM_Get_DevNode_Property_ExW The CM_Get_DevNode_Property_ExW function retrieves a device instance property.
CM_Get_DevNode_Property_Keys The CM_Get_DevNode_Property_Keys function retrieves an array of the device property keys that represent the device properties that are set for a device instance.
CM_Get_DevNode_Property_Keys_Ex The CM_Get_DevNode_Property_Keys_Ex function retrieves an array of the device property keys that represent the device properties that are set for a device instance.
CM_Get_DevNode_PropertyW The CM_Get_DevNode_Property function retrieves a device instance property.
CM_Get_DevNode_Registry_PropertyW The CM_Get_DevNode_Registry_Property function retrieves a specified device property from the registry.
CM_Get_DevNode_Status The CM_Get_DevNode_Status function obtains the status of a device instance from its device node (devnode) in the local machine's device tree.
CM_Get_DevNode_Status_Ex The CM_Get_DevNode_Status_Ex function obtains the status of a device instance from its device node (devnode) on a local or a remote machine's device tree.
CM_Get_First_Log_Conf The CM_Get_First_Log_Conf function obtains the first logical configuration, of a specified configuration type, associated with a specified device instance on the local machine.
CM_Get_First_Log_Conf_Ex The CM_Get_First_Log_Conf_Ex function obtains the first logical configuration associated with a specified device instance on a local or a remote machine.
CM_Get_HW_Prof_Flags_ExA The CM_Get_HW_Prof_Flags_Ex function retrieves the hardware profile-specific configuration flags for a device instance on a remote machine or a local machine.
CM_Get_HW_Prof_Flags_ExW The CM_Get_HW_Prof_Flags_Ex function retrieves the hardware profile-specific configuration flags for a device instance on a remote machine or a local machine.
CM_Get_HW_Prof_FlagsA The CM_Get_HW_Prof_Flags function retrieves the hardware profile-specific configuration flags for a device instance on a local machine.
CM_Get_HW_Prof_FlagsW The CM_Get_HW_Prof_Flags function retrieves the hardware profile-specific configuration flags for a device instance on a local machine.
CM_Get_Log_Conf_Priority The CM_Get_Log_Conf_Priority function obtains the configuration priority of a specified logical configuration on the local machine.
CM_Get_Log_Conf_Priority_Ex The CM_Get_Log_Conf_Priority_Ex function obtains the configuration priority of a specified logical configuration on a local or a remote machine.
CM_Get_Next_Log_Conf The CM_Get_Next_Log_Conf function obtains the next logical configuration associated with a specific device instance on the local machine.
CM_Get_Next_Log_Conf_Ex The CM_Get_Next_Log_Conf_Ex function obtains the next logical configuration associated with a specific device instance on a local or a remote machine.
CM_Get_Next_Res_Des The CM_Get_Next_Res_Des function obtains a handle to the next resource descriptor, of a specified resource type, for a logical configuration on the local machine.
CM_Get_Next_Res_Des_Ex The CM_Get_Next_Res_Des_Ex function obtains a handle to the next resource descriptor, of a specified resource type, for a logical configuration on a local or a remote machine.
CM_Get_Parent The CM_Get_Parent function obtains a device instance handle to the parent node of a specified device node (devnode) in the local machine's device tree.
CM_Get_Parent_Ex The CM_Get_Parent_Ex function obtains a device instance handle to the parent node of a specified device node (devnode) in a local or a remote machine's device tree.
CM_Get_Res_Des_Data The CM_Get_Res_Des_Data function retrieves the information stored in a resource descriptor on the local machine.
CM_Get_Res_Des_Data_Ex The CM_Get_Res_Des_Data_Ex function retrieves the information stored in a resource descriptor on a local or a remote machine.
CM_Get_Res_Des_Data_Size The CM_Get_Res_Des_Data_Size function obtains the buffer size required to hold the information contained in a specified resource descriptor on the local machine.
CM_Get_Res_Des_Data_Size_Ex The CM_Get_Res_Des_Data_Size_Ex function obtains the buffer size required to hold the information contained in a specified resource descriptor on a local or a remote machine.
CM_Get_Resource_Conflict_Count The CM_Get_Resource_Conflict_Count function obtains the number of conflicts contained in a specified resource conflict list.
CM_Get_Resource_Conflict_DetailsW The CM_Get_Resource_Conflict_Details function obtains the details about one of the resource conflicts in a conflict list.
CM_Get_Sibling The CM_Get_Sibling function obtains a device instance handle to the next sibling node of a specified device node (devnode) in the local machine's device tree.
CM_Get_Sibling_Ex The CM_Get_Sibling_Ex function obtains a device instance handle to the next sibling node of a specified device node, in a local or a remote machine's device tree.
CM_Get_Version The CM_Get_Version function returns version 4.0 of the Plug and Play (PnP) Configuration Manager DLL (Cfgmgr32.dll) for a local machine.
CM_Get_Version_Ex The CM_Get_Version_Ex function returns version 4.0 of the Plug and Play (PnP) Configuration Manager DLL (Cfgmgr32.dll) for a local or a remote machine.
CM_Is_Dock_Station_Present The CM_Is_Dock_Station_Present function identifies whether a docking station is present in a local machine.
CM_Is_Dock_Station_Present_Ex The CM_Is_Dock_Station_Present_Ex function identifies whether a docking station is present in a local or a remote machine.
CM_Is_Version_Available The CM_Is_Version_Available function indicates whether a specified version of the Plug and Play (PnP) Configuration Manager DLL (Cfgmgr32.dll) is supported by a local machine.
CM_Is_Version_Available_Ex The CM_Is_Version_Available_Ex function indicates whether a specified version of the Plug and Play (PNP) Configuration Manager DLL (Cfgmgr32.dll) is supported by a local or a remote machine.
CM_Locate_DevNode_ExW The CM_Locate_DevNode_Ex function obtains a device instance handle to the device node that is associated with a specified device instance ID, on a local machine or a remote machine.
CM_Locate_DevNodeA The CM_Locate_DevNode function obtains a device instance handle to the device node that is associated with a specified device instance ID on the local machine.
CM_Locate_DevNodeW The CM_Locate_DevNode function obtains a device instance handle to the device node that is associated with a specified device instance ID on the local machine.
CM_MapCrToWin32Err Converts a specified CONFIGRET code to its equivalent system error code.
CM_Modify_Res_Des The CM_Modify_Res_Des function modifies a specified resource descriptor on the local machine.
CM_Modify_Res_Des_Ex The CM_Modify_Res_Des_Ex function modifies a specified resource descriptor on a local or a remote machine.
CM_Open_Class_KeyW The CM_Open_Class_Key function opens the device setup class registry key, the device interface class registry key, or a specific subkey of a class.
CM_Open_Device_Interface_Key_ExA The CM_Open_Device_Interface_Key_ExA function opens the registry subkey that is used by applications and drivers to store information that is specific to a device interface.
CM_Open_Device_Interface_Key_ExW The CM_Open_Device_Interface_Key_ExW function opens the registry subkey that is used by applications and drivers to store information that is specific to a device interface.
CM_Open_Device_Interface_KeyA The CM_Open_Device_Interface_Key function opens the registry subkey that is used by applications and drivers to store information that is specific to a device interface.
CM_Open_Device_Interface_KeyW The CM_Open_Device_Interface_Key function opens the registry subkey that is used by applications and drivers to store information that is specific to a device interface.
CM_Open_DevNode_Key The CM_Open_DevNode_Key function opens a registry key for device-specific configuration information.
CM_Query_And_Remove_SubTree_ExW The CM_Query_And_Remove_SubTree_Ex function checks whether a device instance and its children can be removed and, if so, it removes them.
CM_Query_And_Remove_SubTreeW The CM_Query_And_Remove_SubTree function checks whether a device instance and its children can be removed and, if so, it removes them.
CM_Query_Resource_Conflict_List The CM_Query_Resource_Conflict_List function identifies device instances having resource requirements that conflict with a specified device instance's resource description.
CM_Reenumerate_DevNode The CM_Reenumerate_DevNode function enumerates the devices identified by a specified device node and all of its children.
CM_Reenumerate_DevNode_Ex The CM_Reenumerate_DevNode_Ex function enumerates the devices identified by a specified device node and all of its children.
CM_Register_Notification Use RegisterDeviceNotification instead of CM_Register_Notification if your code targets Windows 7 or earlier versions of Windows. Kernel mode callers should use IoRegisterPlugPlayNotification instead.
CM_Request_Device_Eject_ExW The CM_Request_Device_Eject_Ex function prepares a local or a remote device instance for safe removal, if the device is removable. If the device can be physically ejected, it will be.
CM_Request_Device_EjectW The CM_Request_Device_Eject function prepares a local device instance for safe removal, if the device is removable. If the device can be physically ejected, it will be.
CM_Request_Eject_PC The CM_Request_Eject_PC function requests that a portable PC, which is inserted in a local docking station, be ejected.
CM_Request_Eject_PC_Ex The CM_Request_Eject_PC_Ex function requests that a portable PC, which is inserted in a local or a remote docking station, be ejected.
CM_Set_Class_Property_ExW The CM_Set_Class_Property_ExW function sets a class property for a device setup class or a device interface class.
CM_Set_Class_PropertyW The CM_Set_Class_Property function sets a class property for a device setup class or a device interface class.
CM_Set_Class_Registry_PropertyW The CM_Set_Class_Registry_Property function sets or deletes a property of a device setup class.
CM_Set_Device_Interface_Property_ExW The CM_Set_Device_Interface_Property_ExW function sets a device property of a device interface.
CM_Set_Device_Interface_PropertyW The CM_Set_Device_Interface_Property function sets a device property of a device interface.
CM_Set_DevNode_Problem The CM_Set_DevNode_Problem function sets a problem code for a device that is installed in a local machine.
CM_Set_DevNode_Problem_Ex The CM_Set_DevNode_Problem_Ex function sets a problem code for a device that is installed in a local or a remote machine.
CM_Set_DevNode_Property_ExW The CM_Set_DevNode_Property_ExW function sets a device instance property.
CM_Set_DevNode_PropertyW The CM_Set_DevNode_Property function sets a device instance property.
CM_Set_DevNode_Registry_PropertyW The CM_Set_DevNode_Registry_Property function sets a specified device property in the registry.
CM_Setup_DevNode The CM_Setup_DevNode function restarts a device instance that is not running because there is a problem with the device configuration.
CM_Uninstall_DevNode The CM_Uninstall_DevNode function removes all persistent state associated with a device instance.
CM_Unregister_Notification Use UnregisterDeviceNotification instead of CM_Unregister_Notification if your code targets Windows 7 or earlier versions of Windows.
CM_WaitNoPendingInstallEvents The CMP_WaitNoPendingInstallEvents (CM_WaitNoPendingInstallEvents) function waits until there are no pending device installation activities for the PnP manager to perform.

Structures

Title Description
BUSNUMBER_DES The BUSNUMBER_DES structure is used for specifying either a resource list or a resource requirements list that describes bus number usage for a device instance.
BUSNUMBER_RANGE The BUSNUMBER_RANGE structure specifies a resource requirements list that describes bus number usage for a device instance. For more information about resource requirements lists, see Hardware Resources.
BUSNUMBER_RESOURCE The BUSNUMBER_RESOURCE structure specifies either a resource list or a resource requirements list that describes bus number usage for a device instance. For more information about resource lists and resource requirements lists, see Hardware Resources.
CM_NOTIFY_EVENT_DATA This is a device notification event data structure.
CM_NOTIFY_FILTER Device notification filter structure.
CONFLICT_DETAILS_A The CONFLICT_DETAILS structure is used as a parameter to the CM_Get_Resource_Conflict_Details function.
CONFLICT_DETAILS_W The CONFLICT_DETAILS structure is used as a parameter to the CM_Get_Resource_Conflict_Details function.
CS_DES The CS_DES structure is used for specifying a resource list that describes device class-specific resource usage for a device instance. For more information about resource lists, see Hardware Resources.
CS_RESOURCE The CS_RESOURCE structure is used for specifying a resource list that describes device class-specific resource usage for a device instance. For more information about resource lists, see Hardware Resources.
DMA_DES The DMA_DES structure is used for specifying either a resource list or a resource requirements list that describes direct memory access (DMA) channel usage for a device instance.
DMA_RANGE The DMA_RANGE structure specifies a resource requirements list that describes DMA channel usage for a device instance. For more information about resource requirements lists, see Hardware Resources.
DMA_RESOURCE The DMA_RESOURCE structure is used for specifying either a resource list or a resource requirements list that describes DMA channel usage for a device instance.
IO_DES The IO_DES structure is used for specifying either a resource list or a resource requirements list that describes I/O port usage for a device instance. For more information about resource lists and resource requirements lists, see Hardware Resources.
IO_RANGE The IO_RANGE structure specifies a resource requirements list that describes I/O port usage for a device instance. For more information about resource requirements lists, see Hardware Resources.
IO_RESOURCE The IO_RESOURCE structure is used for specifying either a resource list or a resource requirements list that describes I/O port usage for a device instance.
IRQ_DES_32 The IRQ_DES structure is used for specifying either a resource list or a resource requirements list that describes IRQ line usage for a device instance. For more information about resource lists and resource requirements lists, see Hardware Resources.
IRQ_DES_64 The IRQ_DES structure is used for specifying either a resource list or a resource requirements list that describes IRQ line usage for a device instance. For more information about resource lists and resource requirements lists, see Hardware Resources.
IRQ_RANGE The IRQ_RANGE structure specifies a resource requirements list that describes IRQ line usage for a device instance. For more information about resource requirements lists, see Hardware Resources.
IRQ_RESOURCE_32 The IRQ_RESOURCE structure is used for specifying either a resource list or a resource requirements list that describes IRQ line usage for a device instance.
IRQ_RESOURCE_64 The IRQ_RESOURCE structure is used for specifying either a resource list or a resource requirements list that describes IRQ line usage for a device instance.
MEM_DES The MEM_DES structure is used for specifying either a resource list or a resource requirements list that describes memory usage for a device instance. For more information about resource lists and resource requirements lists, see Hardware Resources.
MEM_RANGE The MEM_RANGE structure specifies a resource requirements list that describes memory usage for a device instance. For more information about resource requirements lists, see Hardware Resources.
MEM_RESOURCE The MEM_RESOURCE structure is used for specifying either a resource list or a resource requirements list that describes memory usage for a device instance. For more information about resource lists and resource requirements lists, see Hardware Resources.
MFCARD_DES The MFCARD_DES structure is used for specifying either a resource list or a resource requirements list that describes resource usage by one of the hardware functions provided by an instance of a multifunction device.
MFCARD_RESOURCE The MFCARD_RESOURCE structure is used for specifying either a resource list or a resource requirements list that describes resource usage by one of the hardware functions provided by an instance of a multifunction device.
PCCARD_DES The PCCARD_DES structure is used for specifying either a resource list or a resource requirements list that describes resource usage by a PC Card instance. For more information about resource lists and resource requirements lists, see Hardware Resources.
PCCARD_RESOURCE The PCCARD_RESOURCE structure is used for specifying either a resource list or a resource requirements list that describes resource usage by a PC Card instance.

Enumerations

Title Description
CM_NOTIFY_ACTION This enumeration identifies Plug and Play device event types.