getPwrCapabilities 函数 (powerbase.h)

检索有关系统电源功能的信息。

语法

BOOLEAN GetPwrCapabilities(
  [out] PSYSTEM_POWER_CAPABILITIES lpspc
);

[out] lpspc

指向接收信息的 SYSTEM_POWER_CAPABILITIES 结构的指针。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

此函数检索有关当前系统电源管理硬件资源和功能的详细信息。这包括有关电源按钮、盖子开关和电池等硬件功能存在的信息。返回的其他详细信息包括有关当前电源管理功能和可以动态更改的配置的信息，例如当前支持的最低睡眠状态（随着新驱动程序引入系统或系统休眠文件的存在而可能会更改）。

此信息也可通过 CallNtPowerInformation 函数使用 SystemPowerCapabilities 级别获取。

有关使用 PowrProf.h 的详细信息，请参阅电源方案。