Skip to main content

XSpeechSynthesizerCreateStreamFromText

Cria um fluxo de síntese de fala a partir do texto sem formatação especificado.

Sintaxe

Parâmetros

speechSynthesizer   _In_
Tipo: XSpeechSynthesizerHandle
O sintetizador de fala a ser usado. text   _In_z_
Tipo: char*
O texto sem formatação a partir do qual gerar a fala. speechSynthesisStream   _Out_
Tipo: XSpeechSynthesizerStreamHandle*
Um fluxo de síntese de fala que representa a fala gerada a partir do texto sem formatação especificado em text.

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. Se a função falhar porque o fluxo do sintetizador de fala é maior que o tamanho máximo de dados, o valor retornado será definido como E_BOUNDS.

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.
  • Use esta função para sintetizar fala a partir de texto sem formatação e gerar dados de áudio no formato de contêiner WAVE (tipo MIME audio/wav). Depois de usar esta função para criar um fluxo do sintetizador de fala e sintetizar fala a partir de texto sem formatação, use as funções XSpeechSynthesizerGetStreamDataSize e XSpeechSynthesizerGetStreamData para recuperar os dados de áudio do fluxo do sintetizador de fala. Use a função XSpeechSynthesizerCloseStreamHandle para fechar o fluxo do sintetizador de fala depois de recuperar os dados de áudio.
  • O tamanho máximo de dados de um fluxo do sintetizador de fala é 0xffffffff bytes: quatro gigabytes menos um byte. Ocorrerá um erro se você tentar criar um fluxo do sintetizador de fala maior que o tamanho máximo de dados.
  • Para evitar vazamentos de memória, chame a função XSpeechSynthesizerCloseStreamHandle para fechar um identificador de fluxo do sintetizador de fala depois de concluir todas as operações que estão usando o identificador. Todas as operações assíncronas pendentes devem ser concluídas antes que esta função seja chamada.
  • Para obter um exemplo que demonstra como usar a função XSpeechSynthesizerCreateStreamFromText, consulte XSpeechSynthesizerCreate.

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