WDF_DEVICE_STATE Struktur (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die WDF_DEVICE_STATE-Struktur gibt den Plug- und Play-Zustand eines Geräts an.

Syntax

typedef struct _WDF_DEVICE_STATE {
  ULONG         Size;
  WDF_TRI_STATE Disabled;
  WDF_TRI_STATE DontDisplayInUI;
  WDF_TRI_STATE Failed;
  WDF_TRI_STATE NotDisableable;
  WDF_TRI_STATE Removed;
  WDF_TRI_STATE ResourcesChanged;
  WDF_TRI_STATE AssignedToGuest;
} WDF_DEVICE_STATE, *PWDF_DEVICE_STATE;

Elemente

Size

Die Größe dieser Struktur in Byte.

Disabled

Ein WDF_TRI_STATE-typed-Wert, der bei Festlegung auf WdfTrue-angibt, dass das Gerät deaktiviert ist. Weitere Informationen zum typ "WDF_TRI_STATE" finden Sie im folgenden Abschnitt "Hinweise".

DontDisplayInUI

Ein WDF_TRI_STATE-typisierter Wert, der, wenn er auf WdfTrue-festgelegt ist, angibt, dass das Gerät im Geräte-Manager ausgeblendet ist (nicht angezeigt). Weitere Informationen finden Sie unter Anzeigen ausgeblendeter Geräte. (Nachdem Sie dieses Element auf WdfTrue-festgelegt haben, hat das Ändern seines Werts keine Auswirkung.)

Failed

Ein WDF_TRI_STATE-typed-Wert, der bei Festlegung auf WdfTrueangibt, dass das Gerät vorhanden ist, aber fehlgeschlagen ist.

NotDisableable

Ein WDF_TRI_STATE-typed-Wert, der bei Festlegung auf WdfTrue-angibt, dass das Gerät nicht deaktiviert werden kann.

Removed

Ein WDF_TRI_STATE-typed-Wert, der bei Festlegung auf WdfTrue-angibt, dass das Gerät entfernt wurde.

ResourcesChanged

Ein WDF_TRI_STATE-typed-Wert, der bei Festlegung auf WdfTrue-angibt, dass sich die Ressourcenanforderungen des Geräts geändert haben.

AssignedToGuest

Ein WDF_TRI_STATE-typed-Wert, der, wenn auf WdfTrue-festgelegt ist, angibt, dass das Gerät sich als einer Gastpartition meldet.

Bemerkungen

Strukturmber verwenden den WDF_TRI_STATE Typ. Ein Wert von WdfUseDefault gibt an, dass das Framework den Wert verwendet, der von einem niedrigeren Treiber im Stapel bereitgestellt wurde. Wenn beispielsweise ein Bustreiber WdfTrue- für NotDisableable- angibt und der Funktionstreiber des Geräts WdfUseDefault-angibt, verwendet das Framework WdfTrue für den Gerätezustand.

Die WDF_DEVICE_STATE-Struktur wird als Parameter zum WdfDeviceSetDeviceState und WdfDeviceGetDeviceStateverwendet.

Um eine WDF_DEVICE_STATE Struktur zu initialisieren, muss der Treiber WDF_DEVICE_STATE_INITaufrufen.

Weitere Informationen zu den Membern der WDF_DEVICE_STATE-Struktur finden Sie unter PNP_DEVICE_STATE.

Anforderungen

Anforderung	Wert
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Kopfzeile	wdfdevice.h (einschließen Wdf.h)