IMDSPDevice::GetPowerSource 方法 (mswmdm.h)
GetPowerSource 方法报告设备是否能够使用电池和/或外部电源运行,以及它当前运行的电源类型。 如果设备使用电池运行,此方法还会报告电池中剩余总功率的百分比。
语法
HRESULT GetPowerSource(
[out] DWORD *pdwPowerSource,
[out] DWORD *pdwPercentRemaining
);
参数
[out] pdwPowerSource
指向 DWORD 的指针,该 DWORD 接收指示设备的当前电源的值。 值是以下标志之一。
标志 | 描述 |
---|---|
WMDM_POWER_CAP_BATTERY | 媒体设备可以使用电池运行。 |
WMDM_POWER_CAP_EXTERNAL | 媒体设备可以使用外部电源运行。 |
WMDM_POWER_IS_BATTERY | 媒体设备当前使用电池运行。 |
WMDM_POWER_IS_EXTERNAL | 媒体设备当前在外部电源上运行。 |
WMDM_POWER_PERCENT_AVAILABLE | 剩余电量的百分比在 pdwPercentRemaining 中返回。 |
[out] pdwPercentRemaining
如果设备使用电池运行, 则 pdwPercentRemaining 会指定指向包含剩余总电池电量百分比的 DWORD 的指针。
返回值
该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:
- 标准 COM 错误代码
- 转换为 HRESULT 值的 Windows 错误代码
- Windows Media 设备管理器错误代码
注解
只有物理设备报告电源功能和当前电源。 设备的软件实现报告没有电源功能或当前电源。
此方法是可选的。 有关详细信息,请参阅 必需接口和可选接口。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | mswmdm.h |
Library | Mssachlp.lib |