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

Article
08/28/2023

Retourne les paramètres actuels spécifiques à l’effet d’un effet donné dans la chaîne d’effets de la voix.

Syntaxe

\\HRESULT GetEffectParameters(
  [in]  UINT32 EffectIndex,
  [out] void   *pParameters,
  [out] UINT32 ParametersByteSize
);

Paramètres

[in] EffectIndex

Index de base zéro d’un effet dans la chaîne d’effets de la voix.

[out] pParameters

Retourne les valeurs actuelles des paramètres spécifiques à l’effet.

[out] ParametersByteSize

Taille, en octets, du tableau pParameters.

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.

Échoue avec E_NOTIMPL si l’effet ne prend pas en charge une interface de contrôle de paramètre générique.

Remarques

GetEffectParameters retourne toujours les paramètres actuels réels de l’effet. Toutefois, ils peuvent ne pas correspondre aux paramètres définis par l’appel le plus récent à IXAudio2Voice::SetEffectParameters : 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::SetEffectParameters (ou après l’appel IXAudio2::CommitChanges correspondant, si IXAudio2Voice::SetEffectParameters 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

IXAPOParameters::GetParameters

IXAudio2Voice

Vue d’ensemble de XAPO

Partager via