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 |