WDF_STATE_NOTIFICATION_TYPE 枚举 (wdfdevice.h)

[仅适用于 KMDF]

注意

此枚举仅供 Microsoft 内部使用。

WDF_STATE_NOTIFICATION_TYPE枚举标识基于框架的驱动程序将收到的即插即用、电源或电源策略通知的类型。

语法

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

常量

StateNotificationInvalid 值： 0x0000 仅限内部使用。
StateNotificationEnterState 值： 0x0001 在设备的即插即用、电源或电源策略状态机进入指定状态之前，将立即通知驱动程序。
StateNotificationPostProcessState 值： 0x0002 设备即插即用、电源或电源策略状态机进入指定状态后，将立即通知驱动程序。
StateNotificationLeaveState 值： 0x0004 在设备的即插即用、电源或电源策略状态机离开指定状态之前，将立即通知驱动程序。
StateNotificationAllStates 值： StateNotificationEnterState 驱动程序接收 enter-state、postprocess-state 和 leave-state 通知。

注解

当驱动程序设备的框架状态机从状态 a 更改为状态 b 时，框架会通知驱动程序 (驱动程序是否) 注册了适当的事件回调函数，按以下顺序：

1. 调用状态 a 的离开状态通知回调函数。
2. 调用状态 b 的 enter-state 通知回调函数。
3. 将设备的状态从 a 更改为 b。
4. 调用状态 b 的后处理状态通知回调函数。

若要注册状态更改通知，驱动程序可以调用以下方法：

• WdfDeviceInitRegisterPnpStateChangeCallback

• WdfDeviceInitRegisterPowerStateChangeCallback

• WdfDeviceInitRegisterPowerPolicyStateChangeCallback

要求

要求	值
最低 KMDF 版本	1.0
标头	wdfdevice.h (包括 Wdf.h)

另请参阅

WDF_DEVICE_PNP_NOTIFICATION_DATA

WDF_DEVICE_POWER_NOTIFICATION_DATA

WDF_DEVICE_POWER_POLICY_NOTIFICATION_DATA