The CM_Query_Resource_Conflict_List function identifies device instances having resource requirements that conflict with a specified device instance's resource description.
CMAPI CONFIGRET WINAPI CM_Query_Resource_Conflict_List( _Out_ PCONFLICT_LIST pclConflictList, _In_ DEVINST dnDevInst, _In_ RESOURCEID ResourceID, _In_ PCVOID ResourceData, _In_ ULONG ResourceLen, _In_ ULONG ulFlags, _In_opt_ HMACHINE hMachine );
- pclConflictList [out]
Caller-supplied address of a location to receive a handle to a conflict list.
- dnDevInst [in]
Caller-supplied device instance handle that is bound to the machine handle supplied by hMachine.
- ResourceID [in]
Caller-supplied resource type identifier. This must be one of the ResType_-prefixed constants defined in Cfgmgr32.h.
- ResourceData [in]
Caller-supplied pointer to a resource descriptor, which can be one of the structures listed under the CM_Add_Res_Des function's description of ResourceData.
- ResourceLen [in]
Caller-supplied length of the structure pointed to by ResourceData.
- ulFlags [in]
Not used, must be zero.
- hMachine [in, optional]
Caller-supplied machine handle to which the caller-supplied device instance handle is bound.
If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the CR_-prefixed error codes defined in Cfgmgr32.h.
When calling CM_Query_Resource_Conflict_List, specify a device instance handle and resource descriptor. (Resource descriptors for existing device nodes can be obtained by calling CM_Get_Res_Des_Data.) These parameters indicate the specific resources you'd like a specific device to use. The resulting conflict list identifies devices that use the same resources, along with resources reserved by the machine.
After calling CM_Query_Resource_Conflict_List, an application can call CM_Get_Resource_Conflict_Count to determine the number of conflicts contained in the resource conflict list. (The number of conflicts can be zero.) Then the application can call CM_Get_Resource_Conflict_Details for each entry in the conflict list.
After an application has finished using the handle received for pclConflictList, it must call CM_Free_Resource_Conflict_Handle.
For information about using device instance handles that are bound to a local or a remote machine, see CM_Get_Child_Ex.
|Available in Microsoft Windows 2000 and later versions of Windows.|