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

Article
03/04/2024

Définit le niveau de volume global de la voix.

Syntaxe

\\HRESULT SetVolume(
  [in] float  Volume,
  [in] UINT32 OperationSet
);

Paramètres

[in] Volume

Niveau de volume global à utiliser. Pour plus d’informations sur les niveaux de volume, consultez Remarques.

[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

SetVolume contrôle le niveau de volume d’entrée master d’une voix. Le niveau de volume master est appliqué à différents moments en fonction du type de voix. Pour les voix de sous-mixage et de mastering, le niveau de volume est appliqué juste avant l’application du filtre intégré et de la chaîne d’effets de la voix. Pour les voix sources, le niveau de volume master est appliqué après l’application du filtre et de la chaîne d’effets de la voix.

Les niveaux de volume sont exprimés sous forme de multiplicateurs d’amplitude à virgule flottante entre -XAUDIO2_MAX_VOLUME_LEVEL et XAUDIO2_MAX_VOLUME_LEVEL (-2²⁴ à 2²⁴), avec un gain maximal de 144,5 dB. Un niveau de volume de 1.0 signifie qu’il n’y a pas d’atténuation ou de gain et 0 signifie silence. Les niveaux négatifs peuvent être utilisés pour inverser la phase audio. Pour plus d’informations sur le contrôle de volume, consultez Contrôle de volume et de tangage XAudio2 .

RemarqueIXAudio2Voice ::GetVolume retourne toujours le volume le plus récent défini par IXAudio2Voice ::SetVolume. Toutefois, il se peut qu’il ne soit pas encore en vigueur : il prend effet uniquement la prochaine fois que le moteur audio s’exécute après l’appel IXAudio2Voice ::SetVolume (ou après l’appel IXAudio2 ::CommitChanges correspondant, si IXAudio2Voice ::SetVolume 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

Guide pratique pour modifier le volume vocal

Procédure : utiliser des voix prémixées

IXAudio2Voice

Partager via