CM_Get_Resource_Conflict_DetailsA 函数 (cfgmgr32.h)

CM_Get_Resource_Conflict_Details函数获取有关冲突列表中某个资源冲突的详细信息。

语法

CMAPI CONFIGRET CM_Get_Resource_Conflict_DetailsA(
  [in]      CONFLICT_LIST       clConflictList,
  [in]      ULONG               ulIndex,
  [in, out] PCONFLICT_DETAILS_A pConflictDetails
);

参数

[in] clConflictList

冲突列表的调用方提供的句柄，由上一次调用 CM_Query_Resource_Conflict_List获取。

[in] ulIndex

调用方提供的值用作冲突列表中的索引。 此值可能比 CM_Get_Resource_Conflict_Count 返回的数字少 0 到 1。

[in, out] pConflictDetails

调用方提供的 CONFLICT_DETAILS 结构的地址，用于接收冲突详细信息。 调用方必须为结构的 CD_ulSize 和 CD_ulMask 结构提供值。

返回值

如果操作成功，函数将返回CR_SUCCESS。 否则，它将返回 Cfgmgr32.h 中定义的CR_前缀错误代码之一。

备注

若要确定指定设备与计算机上的其他设备之间的资源要求冲突，请使用以下步骤。

1. 调用 CM_Query_Resource_Conflict_List 以获取资源冲突列表的句柄。
2. 调用 CM_Get_Resource_Conflict_Count 以确定资源冲突列表中包含的冲突数。
3. 为冲突列表中的每个条目调用 CM_Get_Resource_Conflict_Details 。

通常不会报告以下冲突：

• 如果资源存在多个冲突，并且只能确定某些冲突的所有者，则不会报告没有可识别所有者的冲突。
• 似乎与指定设备 (即设备本身发生冲突) 不报告。
• 如果多个非即插即用设备使用相同的驱动程序，则可能不会报告这些设备之间的资源冲突。

有时，分配给 HAL 的资源可能会报告为与 HAL 冲突或不可用。

要求

最低受支持的客户端	在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台	桌面
标头	cfgmgr32.h (包括 Cfgmgr32.h)
Library	Cfgmgr32.lib