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傳回的數位。

[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)
程式庫	Cfgmgr32.lib