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_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) (。 不過請注意,某些裝置可能會從系統休眠狀態、S4 (如 PowerSystemHibernate) 所指定,或甚至從系統關機狀態喚醒系統 S5 (,如 PowerSystemShutdown) 所指定。

規格需求

需求
最低支援的用戶端 可在 Microsoft Windows XP 和更新版本的 Windows 作業系統中使用。
標頭 ntpoapi.h (包含 Ntddk.h、Ntpoapi.h)

另請參閱

DEVICE_CAPABILITIES

DEVICE_POWER_STATE

SetupDiGetDeviceRegistryProperty