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

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