IXAudio2Voice::SetOutputVoices メソッド
ボイスの出力を受け取る一連の新しいサブミックス ボイスまたはマスター ボイスを指定します。
構文
HRESULT SetOutputVoices( const XAUDIO2_VOICE_SENDS *pSendList)
パラメーター
- pSendList
[in] デスティネーション ボイスへの XAUDIO2_VOICE_SENDS 構造体ポインターの配列です。pSendList が NULL の場合、ボイスはその出力を現在のマスター ボイスに送信します。ボイスがその出力をどこにも送信しないように設定するには、XAUDIO2_VOICE_SENDS の OutputCount メンバーを 0 に設定します。送信リスト内のすべてのボイスは、同じ入力サンプル レートを使用する必要があります。詳細については、「XAudio2 のサンプル レート変換」を参照してください。
戻り値
正常に実行された場合は S_OK を返し、失敗した場合はエラー コードを返します。XAudio2 固有のエラー コードの説明については、「XAudio2 エラー コード」を参照してください。
解説
このメソッドは、ソース ボイスおよびサブミックス ボイスに対してのみ有効です。マスター ボイスは、オーディオを別のボイスに送信することはできません。
SetOutputVoices を呼び出した後に、ボイスの現在の送信レベルは既定の送信行列に置換されます。新しい送信リスト用のカスタム行列を設定するには、IXAudio2Voice::SetOutputMatrix メソッドを呼び出す必要があります。
コールバック内からの SetOutputVoices の呼び出しは無効です。コールバック内から SetOutputVoices を呼び出すと、XAUDIO2_E_INVALID_CALL が返されます。
注意
SetOutputVoices を呼び出すと、IXAudio2Voice::SetOutputMatrix でそれまでに設定した送信行列がすべて無効になります。
要件
ヘッダー: xaudio2.h で宣言されています。