CM_POWER_DATA 结构 (ntpoapi.h)

  • 项目

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_CAPABILITIES 的 D1Latency 成员。

PD_D2Latency

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

PD_D3Latency

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

PD_PowerStateMapping[POWER_SYSTEM_MAXIMUM]

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

PD_DeepestSystemWake

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

要求

要求 值
最低受支持的客户端 在 Microsoft Windows XP 和更高版本的 Windows 操作系统中可用。
标头 ntpoapi.h (包括 Ntddk.h、Ntpoapi.h)

另请参阅

DEVICE_CAPABILITIES

DEVICE_POWER_STATE

SetupDiGetDeviceRegistryProperty