IWMDMDevice::GetPowerSource メソッド (mswmdm.h)

  • [アーティクル]

GetPowerSource メソッドは、電源とデバイスの残りの電力の割合に関する情報を取得します。

構文

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

パラメーター

[out] pdwPowerSource

デバイスの電源に関する情報を指定する DWORD へのポインター。

返される可能性のある値は、次の 1 つ以上の値のビットごとの 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
Library Mssachlp.lib

こちらもご覧ください

IWMDMDevice インターフェイス