IXAudio2Voice::SetOutputFilterParameters, méthode (xaudio2.h)

Article
08/28/2023

Définit les paramètres de filtre sur l’un des envois de cette voix.

Syntaxe

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

Paramètres

[in] pDestinationVoice

Pointeur IXAudio2Voice vers la voix de destination de l’envoi dont les paramètres de filtre seront définis.

[in] pParameters

Pointeur vers une structure XAUDIO2_FILTER_PARAMETERS contenant les informations de filtre.

[in] OperationSet

Identifie cet appel dans le cadre d’un lot différé. Pour plus d’informations, consultez vue d’ensemble des jeux d’opérations XAudio2 .

Valeur retournée

Retourne S_OK en cas de réussite, un code d’erreur dans le cas contraire. Consultez Codes d’erreur XAudio2 pour obtenir une description des codes d’erreur.

Remarques

SetOutputFilterParameters échoue si l’envoi n’a pas été créé avec l’indicateur XAUDIO2_SEND_USEFILTER. Cette méthode est utilisable uniquement sur les envois appartenant aux voix source et de sous-mixage et n’a aucun effet sur les envois d’une voix de mastering.

RemarqueIXAudio2Voice::GetOutputFilterParameters retourne toujours les paramètres de filtre actuels de cet envoi. Toutefois, ils peuvent ne pas correspondre aux paramètres définis par l’appel IXAudio2Voice::SetOutputFilterParameters le plus récent : les paramètres réels ne sont modifiés que la prochaine fois que le moteur audio s’exécute après l’appel IXAudio2Voice::SetOutputFilterParameters (ou après l’appel IXAudio2::CommitChanges correspondant, si IXAudio2Voice::SetOutputFilterParameters a été appelé avec un ID d’opération différé).

Configuration requise pour la plateforme

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8) ; Kit de développement logiciel (SDK) DirectX (XAudio 2.7)

Spécifications


Plateforme cible	Windows
En-tête	xaudio2.h

Voir aussi

IXAudio2Voice

Partager via