IXAudio2Voice::SetOutputFilterParameters-Methode (xaudio2.h)

Artikel
08/28/2023

Legt die Filterparameter für eine der Gesendeten dieser Stimme fest.

Syntax

\\HRESULT SetOutputFilterParameters(
  [in] IXAudio2Voice                   *pDestinationVoice,
  [in] const XAUDIO2_FILTER_PARAMETERS *pParameters,
  [in] UINT32                          OperationSet
);

Parameter

[in] pDestinationVoice

IXAudio2Voice-Zeiger auf die Zielstimme des Sendens, deren Filterparameter festgelegt werden.

[in] pParameters

Zeiger auf eine XAUDIO2_FILTER_PARAMETERS-Struktur , die die Filterinformationen enthält.

[in] OperationSet

Identifiziert diesen Aufruf als Teil eines verzögerten Batches. Weitere Informationen finden Sie in der Übersicht über XAudio2-Vorgänge .

Rückgabewert

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

Hinweise

SetOutputFilterParameters schlägt fehl, wenn der Sendevorgang nicht mit dem XAUDIO2_SEND_USEFILTER-Flag erstellt wurde. Diese Methode kann nur bei Sendevorgängen verwendet werden, die zu Quell- und Submixstimme gehören, und hat keine Auswirkungen auf die Sendevorgänge einer Masterstimme.

HinweisIXAudio2Voice::GetOutputFilterParameters gibt immer die aktuellen Filterparameter dieses Sendevorgangs zurück. Diese stimmen jedoch möglicherweise nicht mit den Parametern überein, die vom letzten IXAudio2Voice::SetOutputFilterParameters-Aufruf festgelegt wurden: Die tatsächlichen Parameter werden nur bei der nächsten Ausführung der Audio-Engine nach dem IXAudio2Voice::SetOutputFilterParameters-Aufruf (oder nach dem entsprechenden IXAudio2:CommitChanges-Aufruf geändert, wenn IXAudio2Voice::SetOutputFilterParameters mit einer verzögerten Vorgangs-ID aufgerufen wurde).

Plattformanforderungen

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Requirements (Anforderungen)


Zielplattform	Windows
Kopfzeile	xaudio2.h

Weitere Informationen

IXAudio2Voice

Share via