WDF_STATE_NOTIFICATION_TYPE-Enumeration (wdfdevice.h)

  • Artikel

[Gilt nur für KMDF]

Hinweis

Diese Enumeration ist nur für die interne Verwendung von Microsoft vorgesehen.

Die WDF_STATE_NOTIFICATION_TYPE-Enumeration gibt den Typ der Plug & Play-, Energie- oder Energierichtlinienbenachrichtigung an, die ein frameworkbasierter Treiber empfängt.

Syntax

typedef enum _WDF_STATE_NOTIFICATION_TYPE {
  StateNotificationInvalid = 0x0000,
  StateNotificationEnterState = 0x0001,
  StateNotificationPostProcessState = 0x0002,
  StateNotificationLeaveState = 0x0004,
  StateNotificationAllStates = StateNotificationEnterState | StateNotificationPostProcessState | StateNotificationLeaveState
} WDF_STATE_NOTIFICATION_TYPE;

Konstanten

 
StateNotificationInvalid
Wert: 0x0000
Nur zur internen Verwendung.
StateNotificationEnterState
Wert: 0x0001
Der Treiber wird unmittelbar benachrichtigt, bevor der Plug & Play- oder Energierichtliniencomputer eines Geräts in einen angegebenen Zustand wechselt.
StateNotificationPostProcessState
Wert: 0x0002
Der Treiber wird sofort benachrichtigt, nachdem der Plug & Play- oder Energierichtliniencomputer eines Geräts in einen angegebenen Zustand versetzt wurde.
StateNotificationLeaveState
Wert: 0x0004
Der Treiber wird unmittelbar benachrichtigt, bevor der Plug & Play- oder Energierichtlinien-Computer eines Geräts einen angegebenen Zustand verlässt.
StateNotificationAllStates
Wert: StateNotificationEnterState
Der Treiber empfängt Benachrichtigungen zu "Enter-State", "Postprocess-State" und "Leave-State".

Hinweise

Wenn sich der Zustandscomputer des Frameworks für das Gerät eines Treibers von Zustand a in Zustand b ändert, benachrichtigt das Framework den Treiber (wenn der Treiber eine entsprechende Ereignisrückruffunktion registriert hat) in der folgenden Sequenz:

  1. Ruft die Rückruffunktion für Benachrichtigungen über den Verlassenszustand von State a auf.
  2. Ruft die Rückruffunktion für die Eingabezustandsbenachrichtigung von Zustand b auf.
  3. Ändert den Zustand des Geräts von a in b.
  4. Ruft die Rückruffunktion für die Postprocess-State-Benachrichtigung von Zustand b auf.
Um sich für die Benachrichtigung über eine Zustandsänderung zu registrieren, kann der Treiber die folgenden Methoden aufrufen:

Anforderungen

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

Weitere Informationen

WDF_DEVICE_PNP_NOTIFICATION_DATA

WDF_DEVICE_POWER_NOTIFICATION_DATA

WDF_DEVICE_POWER_POLICY_NOTIFICATION_DATA