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 を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。
リターン コード | 説明 |
---|---|
|
パラメーター dwCount がストリーム内のチャネル数と等しくないか、 pfVolumes 配列要素の値が 0.0 から 1.0 の範囲ではありません。 |
|
パラメーター pfVolumes は NULL です。 |
|
オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。 |
|
Windows オーディオ サービスが実行されていません。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | audioclient.h |