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。

規格需求

另請參閱

CM_Free_Resource_Conflict_Handle

CM_Get_Child_Ex

CM_Get_Res_Des_Data

CM_Get_Resource_Conflict_Count

CM_Get_Resource_Conflict_Details