Skip to main content

XSpeechSynthesizerCreateStreamFromText

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

Syntaxe

Paramètres

speechSynthesizer   _In_
Type : XSpeechSynthesizerHandle
Le synthétiseur vocal à utiliser. text   _In_z_
Type : char*
Le texte brut à partir duquel générer la parole. speechSynthesisStream   _Out_
Type : XSpeechSynthesizerStreamHandle*
Un 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écuritaire 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 de 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 une fois les données audio récupérées.
  • 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 plus grand que 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 un exemple montrant comment utiliser la fonction XSpeechSynthesizerCreateStreamFromText, 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

Documentation conceptuelle

Voir aussi

XAccessibility
XSpeechSynthesizerCloseStreamHandle
XSpeechSynthesizer
Last modified on October 6, 2026