次の方法で共有


IXAudio2Voice::SetOutputVoices メソッド

ボイスの出力を受け取る一連の新しいサブミックス ボイスまたはマスター ボイスを指定します。

構文

HRESULT SetOutputVoices(         const XAUDIO2_VOICE_SENDS *pSendList)

パラメーター

  • pSendList
    [in] デスティネーション ボイスへの XAUDIO2_VOICE_SENDS 構造体ポインターの配列です。pSendList が NULL の場合、ボイスはその出力を現在のマスター ボイスに送信します。ボイスがその出力をどこにも送信しないように設定するには、XAUDIO2_VOICE_SENDSOutputCount メンバーを 0 に設定します。送信リスト内のすべてのボイスは、同じ入力サンプル レートを使用する必要があります。詳細については、「XAudio2 のサンプル レート変換」を参照してください。

戻り値

正常に実行された場合は S_OK を返し、失敗した場合はエラー コードを返します。XAudio2 固有のエラー コードの説明については、「XAudio2 エラー コード」を参照してください。

解説 

このメソッドは、ソース ボイスおよびサブミックス ボイスに対してのみ有効です。マスター ボイスは、オーディオを別のボイスに送信することはできません。

SetOutputVoices を呼び出した後に、ボイスの現在の送信レベルは既定の送信行列に置換されます。新しい送信リスト用のカスタム行列を設定するには、IXAudio2Voice::SetOutputMatrix メソッドを呼び出す必要があります。

コールバック内からの SetOutputVoices の呼び出しは無効です。コールバック内から SetOutputVoices を呼び出すと、XAUDIO2_E_INVALID_CALL が返されます。

注意

SetOutputVoices を呼び出すと、IXAudio2Voice::SetOutputMatrix でそれまでに設定した送信行列がすべて無効になります。

要件

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

関連項目

IXAudio2Voice