IXAudio2Voice::SetOutputVoices メソッド (xaudio2.h)

音声の出力を受信する新しいサブミックスまたはマスタリング音声のセットを指定します。

構文

\\HRESULT SetOutputVoices(
  [in] const XAUDIO2_VOICE_SENDS *pSendList
);

パラメーター

[in] pSendList

宛先音声 へのXAUDIO2_VOICE_SENDS 構造体ポインターの配列。 pSendList が NULL の場合、音声はその出力を現在のマスタリング音声に送信します。 音声が出力をどこにも送信しないように設定するには、XAUDIO2_VOICE_SENDSの OutputCount メンバーを 0 に設定します。 送信リスト内のすべての音声の入力サンプル レートは同じである必要があります。詳細については、「 XAudio2 サンプル レート変換 」を参照してください。

戻り値

成功した場合はS_OKを返し、それ以外の場合はエラー コードを返します。 XAudio2 固有のエラー コードの説明については、「XAudio2 エラー コード」を参照してください。

解説

このメソッドは、ソースとサブミックスの音声でのみ有効です。 マスタリング音声は、別の音声にオーディオを送信することはできません。

SetOutputVoices を呼び出すと、音声の現在の送信レベルが既定の送信マトリックスに置き換えられます。 新しい sendlist のカスタム マトリックスを設定するには、 IXAudio2Voice::SetOutputMatrix メソッドを呼び出す必要があります。

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

メモSetOutputVoices を呼び出すと、IXAudio2Voice::SetOutputMatrix で以前に設定されたすべての送信マトリックスが無効になります。

 

プラットフォームの要件

Windows 8、Windows Phone 8 (XAudio 2.8);DirectX SDK (XAudio 2.7)

必要条件

対象プラットフォーム	Windows
ヘッダー	xaudio2.h

関連項目

IXAudio2Voice