WDF_DEVICE_STATE-Struktur (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die WDF_DEVICE_STATE-Struktur gibt den Plug & 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;

Member

Size

Die Größe (in Bytes) dieser Struktur.

Disabled

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

DontDisplayInUI

Ein WDF_TRI_STATE typisierter Wert, der bei Festlegung auf WdfTrue angibt, dass das Gerät in 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 des Werts keine Auswirkungen.)

Failed

Ein WDF_TRI_STATE typisierter Wert, der bei Festlegung auf WdfTrue angibt, dass das Gerät vorhanden ist, aber ein Fehler aufgetreten ist.

NotDisableable

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

Removed

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

ResourcesChanged

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

AssignedToGuest

Ein WDF_TRI_STATE typisierter Wert, der bei Festlegung auf WdfTrue angibt, dass das Gerät sich selbst als einer Gastpartition zugewiesen meldet.

Hinweise

Strukturmember 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ätestatus.

Die WDF_DEVICE_STATE-Struktur wird als Parameter für WdfDeviceSetDeviceState und WdfDeviceGetDeviceState verwendet.

Um eine WDF_DEVICE_STATE-Struktur zu initialisieren, muss der Treiber WDF_DEVICE_STATE_INIT aufrufen.

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

Anforderungen

Anforderung	Wert
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfdevice.h (einschließen von Wdf.h)