IXAudio2Voice::SetOutputVoices-Methode (xaudio2.h)

  • Artikel

Legt einen neuen Satz von Submix- oder Masterstimme fest, um die Ausgabe der Stimme zu empfangen.

Syntax

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

Parameter

[in] pSendList

Array von XAUDIO2_VOICE_SENDS Strukturzeigern auf Zielstimmzeichen. Wenn pSendList NULL ist, sendet die Stimme ihre Ausgabe an die aktuelle Masterstimme. Legen Sie den OutputCount-Member von XAUDIO2_VOICE_SENDS auf 0 fest, um die Stimme so festzulegen, dass ihre Ausgabe nicht an einen beliebigen Ort gesendet wird. Alle Stimmen in einer Sendeliste müssen die gleiche Eingabe-Abtastrate aufweisen. Weitere Informationen finden Sie unter XAudio2 Sample Rate Conversions .

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück, andernfalls einen Fehlercode. Beschreibungen von XAudio2-spezifischen Fehlercodes finden Sie unter XAudio2-Fehlercodes.

Hinweise

Diese Methode ist nur für Quell- und Submix-Stimmen gültig. Masterstimme können keine Audiodaten an eine andere Stimme senden.

Nach dem Aufruf von SetOutputVoices werden die aktuellen Sendestufen einer Stimme durch eine Standardmäßige Sendematrix ersetzt. Die IXAudio2Voice::SetOutputMatrix-Methode muss aufgerufen werden, um eine benutzerdefinierte Matrix für die neue Sendlist festzulegen.

Es ist ungültig, SetOutputVoices innerhalb eines Rückrufs (also IXAudio2EngineCallback oder IXAudio2VoiceCallback) aufzurufen. Wenn SetOutputVoices innerhalb eines Rückrufs aufgerufen wird, wird XAUDIO2_E_INVALID_CALL zurückgegeben.

Hinweis Durch das Aufrufen von SetOutputVoices werden alle Sendematrizen ungültig, die zuvor mit IXAudio2Voice::SetOutputMatrix festgelegt wurden.
 

Plattformanforderungen

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

Requirements (Anforderungen)

   
Zielplattform Windows
Kopfzeile xaudio2.h

Weitere Informationen

IXAudio2Voice