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

另请参阅

IMDSPDevice 接口