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_前缀错误代码之一。

注意从Windows 8开始，CM_Query_Resource_Conflict_List在 Wow64 方案中使用时返回CR_CALL_NOT_IMPLEMENTED。 若要请求有关本地计算机上的硬件资源的信息，必须使用硬件资源 API 实现应用程序的体系结构本机版本。 例如：AMD64 系统的 AMD64 应用程序。
 

注解

调用 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

CM_Get_Child_Ex

CM_Get_Res_Des_Data

CM_Get_Resource_Conflict_Count

CM_Get_Resource_Conflict_Details