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

  • [アーティクル]

SetAllVolumes メソッドは、オーディオ ストリーム内のすべてのチャネルの個々のボリューム レベルを設定します。

構文

HRESULT SetAllVolumes(
  [in] UINT32      dwCount,
  [in] const float *pfVolumes
);

パラメーター

[in] dwCount

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

[in] pfVolumes

オーディオ ストリーム内のチャネルのボリューム レベルの配列へのポインター。 pfVolumes 配列内の要素の数は、dwCount パラメーターによって指定されます。 呼び出し元は、チャネル番号と一致するインデックスを持つ配列要素に、各チャネルのボリューム レベルを書き込みます。 ストリーム形式に N 個のチャネルがある場合、チャネルには 0 から N – 1 の番号が付きます。 有効なボリューム・レベルの範囲は 0.0 から 1.0 です。

戻り値

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

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

要件

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

こちらもご覧ください

IAudioStreamVolume インターフェイス

IAudioStreamVolume::GetChannelCount