wdm.h () CM_POWER_DATA 结构

CM_POWER_DATA结构包含设备电源管理状态和功能的相关信息。

语法

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;

成员

PD_Size

此结构的大小(以字节为单位)。

PD_MostRecentPowerState

表示设备最新电源状态的 DEVICE_POWER_STATE 值。

PD_Capabilities

设备电源功能,由以下位标志的组合表示:

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

从 D1 状态返回 D0 状态时设备的延迟。 有关详细信息,请参阅 DEVICE_CAPABILITIESD1Latency 成员。

PD_D2Latency

从 D2 状态返回 D0 状态时设备的延迟。 有关详细信息,请参阅DEVICE_CAPABILITIESD2Latency 成员。

PD_D3Latency

从 D3 状态返回 D0 状态时设备的延迟。 有关详细信息,请参阅 DEVICE_CAPABILITIESD3Latency 成员。

PD_PowerStateMapping[POWER_SYSTEM_MAXIMUM]

一个由DEVICE_POWER_STATE值构成的数组,表示每个系统电源状态可以实现的最大设备电源状态。 有关详细信息,请参阅 DEVICE_CAPABILITIESDeviceState 成员。

PD_DeepestSystemWake

指定设备可从中唤醒系统最不供电的系统状态。 PD_DeepestSystemWake通常指示由 PowerSystemSleeping1、PowerSystemSleeping2PowerSystemSleeping3 指定的系统睡眠状态之一、S1、S2 或 S3 (,分别) 。 但是,请注意,某些设备可能能够从系统休眠状态唤醒系统、由 PowerSystemHibernate) 指定的 S4 (,甚至从系统关闭状态(S5 (由 PowerSystemShutdown) 指定)。

要求

   
最低受支持的客户端 在 Microsoft Windows XP 及更高版本的 Windows 操作系统中可用。
Header wdm.h (包括 Ntddk.h、Ntpoapi.h)

另请参阅

DEVICE_CAPABILITIES

DEVICE_POWER_STATE

SetupDiGetDeviceRegistryProperty