GetPwrCapabilities 函式 (powerbase.h)

擷取系統電源功能的相關信息。

語法

BOOLEAN GetPwrCapabilities(
  [out] PSYSTEM_POWER_CAPABILITIES lpspc
);

參數

[out] lpspc

接收資訊的 SYSTEM_POWER_CAPABILITIES 結構的指標。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

此函式會擷取目前系統電源管理硬體資源和功能的詳細資訊。 這包括電源按鈕、開關和電池等硬體功能存在的相關信息。 傳回的其他詳細數據包括目前電源管理功能和可動態變更的組態資訊，例如目前支援的最小睡眠狀態，這可能會隨著新驅動程式導入系統或系統休眠檔案的存在而變更。

這項資訊也可透過 CallNtPowerInformation 函式使用 SystemPowerCapabilities 層級取得。

如需使用 PowrProf.h 的詳細資訊，請參閱 Power Schemes。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	powerbase.h
程式庫	PowrProf.lib
Dll	PowrProf.dll

另請參閱

CallNtPowerInformation

電源管理功能

SYSTEM_POWER_CAPABILITIES