GetPwrCapabilities 関数 (powerbase.h)
システム電源機能に関する情報を取得します。
構文
BOOLEAN GetPwrCapabilities(
[out] PSYSTEM_POWER_CAPABILITIES lpspc
);
パラメーター
[out] lpspc
情報を受け取る SYSTEM_POWER_CAPABILITIES 構造体へのポインター。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
この関数は、現在のシステム電源管理ハードウェア リソースと機能に関する詳細情報を取得します。 これには、電源ボタン、カバー スイッチ、バッテリーなどのハードウェア機能の存在に関する情報が含まれます。 返されるその他の詳細には、現在サポートされている最小スリープ状態(新しいドライバーがシステムに導入されると変更される可能性がある)、システム休止状態ファイルの存在など、動的に変更できる現在の電源管理機能と構成に関する情報が含まれます。
この情報は、SystemPowerCapabilities レベルを使用して CallNtPowerInformation 関数を使用して入手することもできます。
PowrProf.h の使用方法の詳細については、「 Power Schemes」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | powerbase.h |
| Library | PowrProf.lib |
| [DLL] | PowrProf.dll |