次の方法で共有


IChannelAudioVolume::GetAllVolumes メソッド (audioclient.h)

GetAllVolumes メソッドは、オーディオ セッション内のすべてのチャネルのボリューム レベルを取得します。

構文

HRESULT GetAllVolumes(
  [in]  UINT32 dwCount,
  [out] float  *pfVolumes
);

パラメーター

[in] dwCount

pfVolumes 配列内の要素の数。 dwCount パラメーターは、オーディオ セッションのストリーム形式のチャネル数と等しい必要があります。 チャネルの数を取得するには、 IChannelAudioVolume::GetChannelCount メソッドを 呼び出します。

[out] pfVolumes

オーディオ セッション内のチャネルのボリューム レベルの配列へのポインター。 このパラメーターは、メソッドが個々のチャネルのボリューム レベルを書き込む呼び出し元によって割り当てられた float 配列を指します。 ボリューム レベルの範囲は 0.0 から 1.0 です。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード 説明
E_INVALIDARG
パラメーター dwCount は、オーディオ セッションのストリーム形式のチャネル数と等しくありません。
E_POINTER
パラメーター pfVolumesNULL です
AUDCLNT_E_DEVICE_INVALIDATED
オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。
AUDCLNT_E_SERVICE_NOT_RUNNING
Windows オーディオ サービスが実行されていません。

解説

クライアントは IChannelAudioVolume::SetAllVolumes メソッドまたは IChannelAudioVolume::SetChannelVolume メソッドを呼び出して、オーディオ セッションのチャネルごとのボリューム レベルを設定できます。

要件

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

関連項目

IChannelAudioVolume インターフェイス

IChannelAudioVolume::GetChannelCount

IChannelAudioVolume::SetAllVolumes

IChannelAudioVolume::SetChannelVolume