XAUDIO2_VOICE_SENDS 構造体

単一の出力ボイスからデータを受け取るための一連のボイスを定義します。

構文

typedef struct XAUDIO2_VOICE_SENDS {    UINT32 SendCount;    XAUDIO2_SEND_DESCRIPTOR *pSends;} XAUDIO2_VOICE_SENDS;

メンバー

• SendCount
  単一ボイスの出力を受け取るためのボイスの数です。OutputCount の値に 0 を指定すると、ボイスの出力はどのボイスにも送信されません。
• pSends
  デスティネーション ボイス、およびこれらのボイスに送信する際に使用するフィルターを表す XAUDIO2_SEND_DESCRIPTOR 構造体の配列です。この配列には SendCount 個の要素が含まれている必要があります。SendCount が 0 の場合、pSends を NULL に設定する必要があります。pSends に同じボイスを複数含めることはできません。

解説　

pSends が NULL 以外の場合、その要素はすべて NULL 以外である必要があります。出力を既定のマスター ボイスに送信するには、NULL に設定された pSendList 引数を使用して IXAudio2Voice::SetOutputVoices を呼び出します。

SendCount を 0 に設定すると、別のボイスに渡すオーディオ出力をまったく生成しないファイル ライターやボリューム メーターなどの特定のエフェクトで役立ちます。

ボイスは必要に応じて、そのボイスの入力サンプル レートから、そのボイスの出力ボイスの入力サンプル レートへシングル サンプル レート変換を実行します。1 回だけサンプル レート変換を実行するため、すべてのボイスの出力ボイスは同じ入力サンプル レートである必要があります。レートが同じ場合は、サンプル レート変換は実行されません。

要件

ヘッダー: xaudio2.h で宣言されています。

関連項目

XAudio2 の構造体
IXAudio2::CreateSourceVoice
IXAudio2::CreateSubmixVoice
IXAudio2Voice::SetOutputVoices
方法:サブミックス ボイスの使用
方法 : ボイス ボリュームの変更
XAudio2 のサンプル レート変換