Partager via


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

Définit les paramètres de filtre de la voix.

Syntaxe

\\HRESULT SetFilterParameters(
  [in] const XAUDIO2_FILTER_PARAMETERS *pParameters,
  [in] UINT32                          OperationSet
);

Paramètres

[in] pParameters

Pointeur vers une structure de 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 ensembles 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

SetFilterParameters échoue si la voix n’a pas été créée avec l’indicateur XAUDIO2_VOICE_USEFILTER.

Cette méthode est utilisable uniquement sur les voix source et de sous-mixage et n’a aucun effet sur la maîtrise des voix.

RemarqueIXAudio2Voice ::GetFilterParameters retourne toujours les paramètres de filtre actuels de cette voix. Toutefois, ceux-ci peuvent ne pas correspondre aux paramètres définis par l’appel IXAudio2Voice ::SetFilterParameters 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 ::SetFilterParameters (ou après l’appel IXAudio2 ::CommitChanges correspondant, si IXAudio2Voice ::SetFilterParameters 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)

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête xaudio2.h

Voir aussi

IXAudio2Voice