Partager via


IXAudio2SourceVoice ::SetSourceSampleRate, méthode (xaudio2.h)

Reconfigure la voix pour consommer les données sources à un taux d’échantillonnage différent de celui spécifié lors de la création de la voix.

Syntaxe

HRESULT SetSourceSampleRate(
  [in] UINT32 NewSourceSampleRate
);

Paramètres

[in] NewSourceSampleRate

Nouvelle fréquence d’échantillonnage à laquelle la voix doit traiter les données envoyées. Les taux d’échantillonnage valides sont de 1 kHz à 200 kHz.

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

La méthode SetSourceSampleRate prend en charge la réutilisation des voix XAudio2 en permettant à une voix de lire des sons avec une variété de taux d’échantillonnage. Pour utiliser SetSourceSampleRate , la voix doit avoir été créée sans les indicateurs XAUDIO2_VOICE_NOPITCH ou XAUDIO2_VOICE_NOSRC et ne doit pas avoir de tampons actuellement mis en file d’attente.

L’utilisation classique de SetSourceSampleRate est pour prendre en charge le regroupement de voix. Par exemple, pour prendre en charge le regroupement de voix, une application précréerait toutes les voix qu’elle s’attend à utiliser. Chaque fois qu’un nouveau son est lu, l’application choisit une voix inactive ou, si toutes les voix sont occupées, choisit la voix la moins importante et appelle SetSourceSampleRate sur la voix avec la fréquence d’échantillonnage du nouveau son. Une fois que SetSourceSampleRate a été appelé sur la voix, l’application peut immédiatement commencer à envoyer et à lire des tampons avec le nouveau taux d’échantillonnage. Cela permet à l’application d’éviter la surcharge liée à la création et à la destruction de voix fréquemment pendant le jeu.

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

IXAudio2SourceVoice