Skip to main content

XSpeechSynthesizerCreateStreamFromSsml

Crée un flux de synthèse vocale à partir du SSML spécifié.

Syntaxe

Paramètres

speechSynthesizer   _In_
Type : XSpeechSynthesizerHandle

Synthétiseur vocal à utiliser.
ssml   _In_z_
Type : char*
Texte à prononcer, modifié avec SSML. Pour plus de détails sur le balisage SSML, consultez les recommandations du W3C.
Cette API exige que les appelants utilisent la version 1.0 de SSML.
speechSynthesisStream   _Out_
Type : XSpeechSynthesizerStreamHandle*
Flux de synthèse vocale qui représente la parole générée à partir du texte brut spécifié dans text.

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite ; sinon, retourne un code d’erreur. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur. Si la fonction échoue parce que le flux du synthétiseur vocal dépasse la taille de données maximale, la valeur de retour est E_BOUNDS.

Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
  • Utilisez cette fonction pour synthétiser la parole à partir de texte brut et générer des données audio au format conteneur WAVE (type MIME audio/wav). Après avoir utilisé cette fonction pour créer un flux de synthétiseur vocal et synthétiser la parole à partir de texte brut, utilisez les fonctions XSpeechSynthesizerGetStreamDataSize et XSpeechSynthesizerGetStreamData pour récupérer les données audio du flux du synthétiseur vocal. Utilisez la fonction XSpeechSynthesizerCloseStreamHandle pour fermer le flux du synthétiseur vocal après avoir récupéré les données audio.
  • La taille de données maximale d’un flux de synthétiseur vocal est de 0xffffffff octets, soit quatre gigaoctets moins un octet. Une erreur se produit si vous tentez de créer un flux de synthétiseur vocal dont la taille dépasse la taille de données maximale.
  • Pour éviter les fuites de mémoire, appelez la fonction XSpeechSynthesizerCloseStreamHandle pour fermer un handle de flux de synthétiseur vocal une fois que vous avez terminé toutes les opérations qui utilisent ce handle. Toutes les opérations asynchrones en attente doivent être terminées avant l’appel de cette fonction.
  • Pour obtenir un exemple illustrant l’utilisation de la fonction XSpeechSynthesizerCreateStreamFromSsml, consultez XSpeechSynthesizerCreate.

Configuration requise

En-tête : XSpeechSynthesizer.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

XAccessibility
XSpeechSynthesizerCloseStreamHandle
XSpeechSynthesizer
Last modified on October 6, 2026