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函式的描述之下。
[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) |
| 程式庫 | Cfgmgr32.lib |
| Dll | Cfgmgr32.dll |
另請參閱
CM_Free_Resource_Conflict_Handle