Skip to main content

XSpeechSynthesizerEnumerateInstalledVoices

Enumera as vozes instaladas e chama o método apontado por callback para cada voz.

Sintaxe

Parâmetros

context   _In_opt_
Tipo: void*
Uma variável especificada pelo usuário que será passada para a função de retorno de chamada para permitir que o chamador recupere dados específicos do chamador. callback   _In_
Tipo: XSpeechSynthesizerInstalledVoicesCallback*
Um ponteiro para o método que será chamado uma vez por voz instalada.

Valor retornado

Tipo: HRESULT Retorna S_OK se for bem-sucedida; caso contrário, retorna um código de erro. Para obter uma lista de códigos de erro, consulte Códigos de erro.

Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Esta função enumera os mecanismos de síntese de fala, ou vozes, instalados no dispositivo. A função invoca a função de retorno de chamada XSpeechSynthesizerInstalledVoicesCallback especificada em callback uma vez para cada voz instalada e passa uma estrutura XSpeechSynthesizerVoiceInformation que contém informações sobre essa voz. O exemplo a seguir demonstra como chamar a função XSpeechSynthesizerEnumerateInstalledVoices para enumerar as vozes instaladas no dispositivo. O exemplo invoca a função de retorno de chamada XSpeechSynthesizerInstalledVoicesCallback para (1) contar o número de vozes instaladas no dispositivo e (2) enviar ao depurador informações sobre cada voz instalada a partir da estrutura XSpeechSynthesizerVoiceInformation.

Requisitos

Cabeçalho: XSpeechSynthesizer.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XAccessibility
XSpeechSynthesizerSetCustomVoice
XSpeechSynthesizer
Last modified on October 6, 2026