ISimpleAudioVolume::GetMasterVolume メソッド (audioclient.h)

GetMasterVolume メソッドは、オーディオセッションのクライアントボリュームレベルを取得します。

構文

HRESULT GetMasterVolume(
  [out] float *pfLevel
);

[out] pfLevel

メソッドがクライアントボリュームレベルを書き込む float 変数へのポインター。ボリュームレベルは、0.0 から 1.0 の範囲の値です。

メソッドが成功した場合は、S_OK を返します。失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターンコード	説明
E_POINTER	パラメーター pfLevel は NULL です。
AUDCLNT_E_DEVICE_INVALIDATED	オーディオエンドポイントデバイスが取り外されているか、オーディオハードウェアまたは関連するハードウェアリソースが再構成、無効、削除、またはその他の方法で使用できなくなります。
AUDCLNT_E_SERVICE_NOT_RUNNING	Windows オーディオサービスが実行されていません。

このメソッドは、セッションのクライアントボリュームレベルを取得します。これは、 ISimpleAudioVolume::SetMasterVolume メソッドの以前の呼び出しでクライアントが設定したボリュームレベルです。

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	audioclient.h