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 デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

物理デバイスのみが電源機能と現在の電源を報告します。デバイスのソフトウェア実装では、電源機能や現在の電源は報告されません。

このメソッドは省略可能です。詳細については、「必須インターフェイスとオプションインターフェイス」を参照してください。