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

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

構文

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

[in] dwCount

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

[out] pfVolumes

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

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

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

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