CM_Query_Resource_Conflict_List 函数 (cfgmgr32.h)
CM_Query_Resource_Conflict_List函数标识具有与指定设备实例的资源说明冲突的资源要求的设备实例。
语法
CMAPI CONFIGRET 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, optional] HMACHINE hMachine
);
参数
[out] pclConflictList
要接收冲突列表句柄的位置的调用方提供的地址。
[in] dnDevInst
调用方提供的设备实例句柄，绑定到 hMachine 提供的计算机句柄。
[in] ResourceID
调用方提供的资源类型标识符。 这必须是 Cfgmgr32.h 中定义的ResType_前缀常量之一。
[in] ResourceData
调用方提供的指向资源描述符的指针，可以是 CM_Add_Res_Des 函数 对 ResourceData 的说明下列出的结构之一。
[in] ResourceLen
ResourceData 指向的结构的调用方提供的长度。
[in] ulFlags
未使用，必须为零。
[in, optional] hMachine
调用方提供的计算机句柄，调用方提供的设备实例句柄绑定到该句柄。
返回值
如果操作成功，函数将返回CR_SUCCESS。 否则，它将返回 Cfgmgr32.h 中定义的CR_前缀错误代码之一。
注解
调用 CM_Query_Resource_Conflict_List 时，请指定设备实例句柄和资源描述符。 (可以通过调用 CM_Get_Res_Des_Data 获取现有设备节点的资源描述符。) 这些参数指示希望特定设备使用的特定资源。 生成的冲突列表标识使用相同资源的设备，以及计算机保留的资源。
调用 CM_Query_Resource_Conflict_List后，应用程序可以调用 CM_Get_Resource_Conflict_Count 来确定资源冲突列表中包含的冲突数。 (冲突数可以为零。) 然后应用程序可以为冲突列表中的每个条目调用 CM_Get_Resource_Conflict_Details 。
应用程序使用为 pclConflictList 收到的句柄后，它必须调用 CM_Free_Resource_Conflict_Handle。
有关使用绑定到本地或远程计算机的设备实例句柄的信息，请参阅 CM_Get_Child_Ex。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。 |
| 目标平台 | 桌面 |
| 标头 | cfgmgr32.h (包括 Cfgmgr32.h) |
| Library | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |
另请参阅
CM_Free_Resource_Conflict_Handle