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 SeriesDocumentation conceptuelle
Voir aussi
XAccessibilityXSpeechSynthesizerCloseStreamHandle
XSpeechSynthesizer
