CM_Get_Resource_Conflict_DetailsA-Funktion (cfgmgr32.h)

  • Artikel

Die CM_Get_Resource_Conflict_Details-Funktion ruft die Details zu einem der Ressourcenkonflikte in einer Konfliktliste ab.

Syntax

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

Parameter

[in] clConflictList

Vom Aufrufer bereitgestelltes Handle für eine Konfliktliste, die durch einen vorherigen Aufruf von CM_Query_Resource_Conflict_List abgerufen wurde.

[in] ulIndex

Vom Aufrufer bereitgestellter Wert, der als Index in die Konfliktliste verwendet wird. Dieser Wert kann von null bis eins kleiner als die von CM_Get_Resource_Conflict_Count zurückgegebene Zahl sein.

[in, out] pConflictDetails

Vom Aufrufer angegebene Adresse einer CONFLICT_DETAILS Struktur, um Konfliktdetails zu empfangen. Der Aufrufer muss Werte für die CD_ulSize - und CD_ulMask-Strukturen der Struktur angeben.

Rückgabewert

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

Hinweise

Führen Sie die folgenden Schritte aus, um konfliktierende Ressourcenanforderungen zwischen einem angegebenen Gerät und anderen Geräten auf einem Computer zu ermitteln.

  1. Rufen Sie CM_Query_Resource_Conflict_List auf, um ein Handle für eine Liste von Ressourcenkonflikten abzurufen.
  2. Rufen Sie CM_Get_Resource_Conflict_Count auf, um die Anzahl der konflikte in der Ressourcenkonfliktliste enthaltenen Konflikte zu ermitteln.
  3. Rufen Sie CM_Get_Resource_Conflict_Details für jeden Eintrag in der Konfliktliste auf.
Die folgenden Konflikte werden in der Regel nicht gemeldet:
  • Wenn mehrere Konflikte für eine Ressource vorliegen und nur die Besitzer einiger Konflikte bestimmt werden können, werden die Konflikte ohne identifizierbare Besitzer nicht gemeldet.
  • Konflikte, die mit dem angegebenen Gerät zu sein scheinen (d. h. das Gerät in Konflikt mit sich selbst), werden nicht gemeldet.
  • Wenn mehrere Nicht-Plug-and-Play-Geräte denselben Treiber verwenden, werden ressourcenbezogene Konflikte zwischen diesen Geräten möglicherweise nicht gemeldet.
Manchmal werden Ressourcen, die der HAL zugewiesen sind, entweder als Konflikt mit der HAL gemeldet oder nicht verfügbar.

Anforderungen

   
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek Cfgmgr32.lib