CM_Query_Resource_Conflict_List-Funktion (cfgmgr32.h)

Artikel
08/22/2023

Die CM_Query_Resource_Conflict_List-Funktion identifiziert Geräteinstanzen mit Ressourcenanforderungen, die mit der Ressourcenbeschreibung eines angegebenen Geräts instance in Konflikt treten.

Syntax

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
);

Parameter

[out] pclConflictList

Vom Aufrufer bereitgestellte Adresse eines Standorts, um ein Handle für eine Konfliktliste zu erhalten.

[in] dnDevInst

Vom Aufrufer bereitgestelltes Gerät instance Handle, das an das von hMachine bereitgestellte Maschinenhandle gebunden ist.

[in] ResourceID

Vom Aufrufer bereitgestellter Ressourcentypbezeichner. Dies muss eine der in Cfgmgr32.h definierten konstanten ResType_ sein.

[in] ResourceData

Vom Aufrufer bereitgestellter Zeiger auf einen Ressourcendeskriptor, der eine der Strukturen sein kann, die unter der Beschreibung von ResourceData der CM_Add_Res_Des-Funktion aufgeführt sind.

[in] ResourceLen

Vom Aufrufer bereitgestellte Länge der Struktur, auf die von ResourceData verwiesen wird.

[in] ulFlags

Nicht verwendet, muss null sein.

[in, optional] hMachine

Vom Aufrufer bereitgestelltes Computerhandle, an das das vom Aufrufer bereitgestellte Gerät instance Handle gebunden ist.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

Hinweis Ab Windows 8 gibt CM_Query_Resource_Conflict_List bei Verwendung in einem Wow64-Szenario CR_CALL_NOT_IMPLEMENTED zurück. Um Informationen zu den Hardwareressourcen auf einem lokalen Computer anzufordern, muss eine architekturnative Version der Anwendung mithilfe der Hardwareressourcen-APIs implementiert werden. Beispiel: Eine AMD64-Anwendung für AMD64-Systeme.

Hinweise

Geben Sie beim Aufrufen CM_Query_Resource_Conflict_List ein Gerät instance Handle und Ressourcendeskriptor an. (Ressourcendeskriptoren für vorhandene Geräteknoten können durch Aufrufen von CM_Get_Res_Des_Data abgerufen werden.) Diese Parameter geben die spezifischen Ressourcen an, die ein bestimmtes Gerät verwenden soll. Die resultierende Konfliktliste identifiziert Geräte, die die gleichen Ressourcen verwenden, zusammen mit ressourcen, die vom Computer reserviert wurden.

Nach dem Aufruf CM_Query_Resource_Conflict_List kann eine Anwendung CM_Get_Resource_Conflict_Count aufrufen, um die Anzahl der konflikte in der Ressourcenkonfliktliste enthaltenen Konflikte zu ermitteln. (Die Anzahl der Konflikte kann null sein.) Anschließend kann die Anwendung für jeden Eintrag in der Konfliktliste CM_Get_Resource_Conflict_Details aufrufen.

Nachdem eine Anwendung das für pclConflictList empfangene Handle verwendet hat, muss sie CM_Free_Resource_Conflict_Handle aufrufen.

Informationen zur Verwendung von Geräte- instance Handles, die an einen lokalen oder Remotecomputer gebunden sind, finden Sie unter CM_Get_Child_Ex.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	cfgmgr32.h (include Cfgmgr32.h)
Bibliothek	Cfgmgr32.lib
DLL	Cfgmgr32.dll

Weitere Informationen

CM_Free_Resource_Conflict_Handle

CM_Get_Child_Ex

CM_Get_Res_Des_Data

CM_Get_Resource_Conflict_Count

CM_Get_Resource_Conflict_Details

Freigeben über