Edit

CM_POWER_DATA structure (wdm.h)

  • Article

The CM_POWER_DATA structure contains information about a device's power management state and capabilities.

Syntax

typedef struct CM_Power_Data_s {
  ULONG              PD_Size;
  DEVICE_POWER_STATE PD_MostRecentPowerState;
  ULONG              PD_Capabilities;
  ULONG              PD_D1Latency;
  ULONG              PD_D2Latency;
  ULONG              PD_D3Latency;
  DEVICE_POWER_STATE PD_PowerStateMapping[POWER_SYSTEM_MAXIMUM];
  SYSTEM_POWER_STATE PD_DeepestSystemWake;
} CM_POWER_DATA, *PCM_POWER_DATA;

Members

PD_Size

The size, in bytes, of this structure.

PD_MostRecentPowerState

A DEVICE_POWER_STATE value representing the device's most recent power state.

PD_Capabilities

The device's power capabilities, represented by a combination of the following bit flags:

PDCAP_D0_SUPPORTED

PDCAP_D1_SUPPORTED

PDCAP_D2_SUPPORTED

PDCAP_D3_SUPPORTED

PDCAP_WAKE_FROM_D0_SUPPORTED

PDCAP_WAKE_FROM_D1_SUPPORTED

PDCAP_WAKE_FROM_D2_SUPPORTED

PDCAP_WAKE_FROM_D3_SUPPORTED

PDCAP_WARM_EJECT_SUPPORTED

PD_D1Latency

The device's latency when returning the D0 state from the D1 state. For more information, see the D1Latency member of DEVICE_CAPABILITIES.

PD_D2Latency

The device's latency when returning the D0 state from the D2 state. For more information, see the D2Latency member of DEVICE_CAPABILITIES.

PD_D3Latency

The device's latency when returning the D0 state from the D3 state. For more information, see the D3Latency member of DEVICE_CAPABILITIES.

PD_PowerStateMapping[POWER_SYSTEM_MAXIMUM]

An array of DEVICE_POWER_STATE values representing the maximum device power state achievable for each system power state. For more information, see the DeviceState member of DEVICE_CAPABILITIES.

PD_DeepestSystemWake

Specifies the least-powered system state from which the device can wake the system. PD_DeepestSystemWake typically indicates one of the system sleeping states, S1, S2, or S3 (as specified by PowerSystemSleeping1, PowerSystemSleeping2, and PowerSystemSleeping3, respectively). Note, however, that some devices might be able to wake the system from the system hibernate state, S4 (as specified by PowerSystemHibernate), or even from the system shutdown state, S5 (as specified by PowerSystemShutdown).

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows XP and later versions of the Windows operating system.
Header wdm.h (include Ntddk.h, Ntpoapi.h)

See also

DEVICE_CAPABILITIES

DEVICE_POWER_STATE

SetupDiGetDeviceRegistryProperty