IWMDMDevice::GetPowerSource 方法 (mswmdm.h)
GetPowerSource 方法會擷取電源的相關信息,以及裝置剩餘電源的百分比。
語法
HRESULT GetPowerSource(
[out] DWORD *pdwPowerSource,
[out] DWORD *pdwPercentRemaining
);
參數
[out] pdwPowerSource
指定裝置電源相關信息的 DWORD 指標。
可能傳回的值是下列一或多個值的位 OR 。
旗標 | 描述 |
---|---|
WMDM_POWER_CAP_BATTERY | 媒體裝置可以在電池上執行。 |
WMDM_POWER_CAP_EXTERNAL | 媒體裝置可以在外部電源上執行。 |
WMDM_POWER_IS_BATTERY | 媒體裝置目前正在電池上執行。 |
WMDM_POWER_IS_EXTERNAL | 媒體裝置目前在外部電源上執行。 |
WMDM_POWER_PERCENT_AVAILABLE | pdwPercentRemaining 中傳回剩餘的電源百分比。 |
[out] pdwPercentRemaining
如果 pdwPowerSource 包含WMDM_POWER_PERCENT_AVAILABLE,則為 DWORD 的指標,指定裝置中剩餘的電源百分比。
傳回值
方法會傳回 HRESULT。 Windows Media 裝置管理員 中的所有介面方法都可以傳回下列任何一種錯誤碼類別:
- 標準 COM 錯誤碼
- 轉換成 HRESULT 值的 Windows 錯誤碼
- Windows Media 裝置管理員 錯誤碼
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | mswmdm.h |
程式庫 | Mssachlp.lib |