ISimpleAudioVolume::GetMasterVolume メソッド (audioclient.h)
GetMasterVolume メソッドは、オーディオ セッションのクライアント ボリューム レベルを取得します。
構文
HRESULT GetMasterVolume(
[out] float *pfLevel
);
パラメーター
[out] pfLevel
メソッドがクライアント ボリューム レベルを書き込む float 変数へのポインター。 ボリューム レベルは、0.0 から 1.0 の範囲の値です。
戻り値
メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。
| リターン コード | 説明 |
|---|---|
|
パラメーター pfLevel は NULL です。 |
|
オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。 |
|
Windows オーディオ サービスが実行されていません。 |
注釈
このメソッドは、セッションのクライアント ボリューム レベルを取得します。 これは、 ISimpleAudioVolume::SetMasterVolume メソッドの以前の呼び出しでクライアントが設定したボリューム レベルです。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | audioclient.h |