Edit

DEVICE_WAKE_DEPTH enumeration (wdm.h)

  • Article

The DEVICE_WAKE_DEPTH enumeration specifies the deepest device power state from which a device can trigger a wake signal.

Syntax

typedef enum _DEVICE_WAKE_DEPTH {
  DeviceWakeDepthNotWakeable,
  DeviceWakeDepthD0,
  DeviceWakeDepthD1,
  DeviceWakeDepthD2,
  DeviceWakeDepthD3hot,
  DeviceWakeDepthD3cold,
  DeviceWakeDepthMaximum
} DEVICE_WAKE_DEPTH, *PDEVICE_WAKE_DEPTH;

Constants

 
DeviceWakeDepthNotWakeable
There is no device power state that can trigger a wake signal.
DeviceWakeDepthD0
D0 is the deepest device power state from which the device can trigger a wake signal. For more information, see Remarks.
DeviceWakeDepthD1
D1 is the deepest low-power device power state from which the device can trigger a wake signal.
DeviceWakeDepthD2
D2 is the deepest low-power device power state from which the device can trigger a wake signal.
DeviceWakeDepthD3hot
D3hot is the deepest low-power device power state from which the device can trigger a wake signal.
DeviceWakeDepthD3cold
D3cold is the deepest low-power device power state from which the device can trigger a wake signal.
DeviceWakeDepthMaximum
Reserved for use by the operating system.

Remarks

The DeepestWakeableDstate parameter of the GetIdleWakeInfo routine is a pointer to a variable of type DEVICE_WAKE_DEPTH.

The drivers for most devices have no reason to arm a wake signal when the device is in D0. These drivers can treat the DeviceWakeDepthD0 output value as equivalent to a call to the GetIdleWakeInfo routine that fails and returns an error status.

Requirements

Requirement Value
Header wdm.h (include Wdm.h)

See also

GetIdleWakeInfo