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.
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;
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.
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.
Anforderung | Wert |
---|---|
KMDF-Mindestversion | 1.0 |
UMDF-Mindestversion | 2.0 |
Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |