Skip to main content

XSpeechSynthesizerEnumerateInstalledVoices

Énumère les voix installées et appelle la méthode désignée par callback pour chaque voix.

Syntaxe

Paramètres

context   _In_opt_
Type : void*
Variable spécifiée par l’utilisateur qui est transmise à la fonction de rappel pour permettre à l’appelant de récupérer des données qui lui sont propres. callback   _In_
Type : XSpeechSynthesizerInstalledVoicesCallback*
Pointeur vers la méthode qui est appelée une fois par voix installée.

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.

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.
Cette fonction énumère les moteurs de synthèse vocale, ou voix, installés sur l’appareil. La fonction appelle la fonction de rappel XSpeechSynthesizerInstalledVoicesCallback spécifiée dans callback une fois pour chaque voix installée, et lui transmet une structure XSpeechSynthesizerVoiceInformation qui contient des informations sur cette voix. L’exemple suivant montre comment appeler la fonction XSpeechSynthesizerEnumerateInstalledVoices pour énumérer les voix installées sur l’appareil. L’exemple appelle la fonction de rappel XSpeechSynthesizerInstalledVoicesCallback pour (1) compter le nombre de voix installées sur l’appareil et (2) envoyer au débogueur les informations de la structure XSpeechSynthesizerVoiceInformation pour chaque voix installée.

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
XSpeechSynthesizerSetCustomVoice
XSpeechSynthesizer
Last modified on October 6, 2026