CONFLICT_DETAILS_W-Struktur (cfgmgr32.h)

Die CONFLICT_DETAILS-Struktur wird als Parameter für die CM_Get_Resource_Conflict_Details-Funktion verwendet.

Syntax

typedef struct _CONFLICT_DETAILS_W {
  ULONG   CD_ulSize;
  ULONG   CD_ulMask;
  DEVINST CD_dnDevInst;
  RES_DES CD_rdResDes;
  ULONG   CD_ulFlags;
  WCHAR   CD_szDescription[MAX_PATH];
} CONFLICT_DETAILS_W, *PCONFLICT_DETAILS_W;

Member

CD_ulSize

Größe der CONFLICT_DETAILS-Struktur in Byte.

CD_ulMask

Ein oder mehrere Bitflags, die vom Aufrufer von CM_Get_Resource_Conflict_Details bereitgestellt werden. Die Bitflags werden in der folgenden Tabelle beschrieben.

Flag Beschreibung
CM_CDMASK_DEVINST Wenn dieser Wert festgelegt ist, gibt CM_Get_Resource_Conflict_Details einen Wert für den CD_dnDevInst-Member an.
CM_CDMASK_RESDES Wird nicht verwendet.
CM_CDMASK_FLAGS Wenn festgelegt, gibt CM_Get_Resource_Conflict_Details einen Wert für den CD_ulFlags-Member an.
CM_CDMASK_DESCRIPTION Wenn festgelegt, gibt CM_Get_Resource_Conflict_Details einen Wert für den CD_szDescription-Member an.

CD_dnDevInst

Wenn CM_CDMASK_DEVINST in CD_ulMask festgelegt ist, erhält dieses Mitglied ein Handle für ein Gerät instance mit in Konflikt stehenden Ressourcen. Wenn ein Handle nicht abgerufen werden kann, erhält der Member -1.

CD_rdResDes

Wird nicht verwendet.

CD_ulFlags

Wenn CM_CDMASK_FLAGS in CD_ulMask festgelegt ist, kann dieses Element Bitflags empfangen, die in der folgenden Tabelle aufgeführt sind.

Flag Beschreibung
CM_CDFLAGS_DRIVER Wenn festgelegt, stellt die im CD_szDescription-Member enthaltene Zeichenfolge einen Treibernamen anstelle eines Gerätenamens dar, und CD_dnDevInst ist -1.
CM_CDFLAGS_ROOT_OWNED Wenn dieser Wert festgelegt ist, gehören die in Konflikt stehenden Ressourcen dem Stammgerät (d. h. der HAL), und CD_dnDevInst ist -1.
CM_CDFLAGS_RESERVED Wenn festgelegt, kann der Besitzer der in Konflikt stehenden Ressourcen nicht ermittelt werden, und CD_dnDevInst ist -1.

CD_szDescription[MAX_PATH]

Wenn CM_CDMASK_DESCRIPTION in CD_ulMask festgelegt ist, erhält dieser Member eine MIT NULL endende Textzeichenfolge, die eine Beschreibung des Geräts darstellt, das die Ressourcen besitzt. Wenn CM_CDFLAGS_DRIVER in CD_ulFlags festgelegt ist, stellt diese Zeichenfolge einen Treibernamen dar. Wenn CM_CDFLAGS_ROOT_OWNED oder CM_CDFLAGS_RESERVED festgelegt ist, ist der Zeichenfolgenwert NULL.

Hinweise

Hinweis

Der cfgmgr32.h-Header definiert CONFLICT_DETAILS als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Header cfgmgr32.h (include Cfgmgr32.h)

Weitere Informationen

CM_Get_Resource_Conflict_Details