共用方式為

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_CAPABILITIES的 DeviceState 成員。

PD_DeepestSystemWake

指定裝置可以喚醒系統的最低電源系統狀態。 PD_DeepestSystemWake 通常表示其中一個系統睡眠狀態 S1、S2 或 S3（如 PowerSystemSleeping1所指定、PowerSystemSleeping2，以及分別 PowerSystemSleeping3。 不過，請注意，某些裝置可能能夠從系統休眠狀態、S4（如 PowerSystemHibernate所指定），或甚至從系統關機狀態 S5 （如 PowerSystemShutdown所指定）。

要求

要求 價值
最低支援的用戶端 Microsoft Windows XP 和更新版本的 Windows作系統中提供。
標頭 ntpoapi.h （include Ntddk.h， Ntpoapi.h）

另請參閱

DEVICE_CAPABILITIES

DEVICE_POWER_STATE

SetupDiGetDeviceRegistryProperty