IMDSPDevice：：GetPowerSource 方法 (mswmdm.h)

GetPowerSource 方法會報告裝置是否能夠在電池、外部電源或兩者上執行，以及其目前執行的電源類型。如果裝置在電池上執行，此方法也會報告電池中剩餘電力的百分比。

語法

HRESULT GetPowerSource(
  [out] DWORD *pdwPowerSource,
  [out] DWORD *pdwPercentRemaining
);

[out] pdwPowerSource

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 中的所有介面方法裝置管理員都可以傳回下列任何錯誤碼類別：

如需可能錯誤碼的廣泛清單，請參閱錯誤碼。

只有實體裝置會報告電源功能和目前的電源來源。裝置的軟體實作不會報告電源功能或目前的電源。

這個方法是一個選擇項目。如需詳細資訊，請參閱強制和選擇性介面。