XSpeechSynthesizerCreateStreamFromText
Crea una secuencia de síntesis de voz a partir del texto sin formato especificado.Sintaxis
Parámetros
speechSynthesizer _In_Tipo: XSpeechSynthesizerHandle El sintetizador de voz que se usará. text _In_z_
Tipo: char* El texto sin formato a partir del cual se generará la voz. speechSynthesisStream _Out_
Tipo: XSpeechSynthesizerStreamHandle* Una secuencia de síntesis de voz que representa la voz generada a partir del texto sin formato especificado en text.
Valor devuelto
Tipo: HRESULT Devuelve S_OK si se realiza correctamente; de lo contrario, devuelve un código de error. Para obtener una lista de códigos de error, consulte Códigos de error. Si la función produce un error porque la secuencia del sintetizador de voz es mayor que el tamaño máximo de datos, el valor devuelto se establece en E_BOUNDS.Comentarios
No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
-
Use esta función para sintetizar voz a partir de texto sin formato y para generar datos de audio en el formato de contenedor WAVE (tipo MIME
audio/wav). Después de usar esta función para crear una secuencia de sintetizador de voz y sintetizar voz a partir de texto sin formato, use las funciones XSpeechSynthesizerGetStreamDataSize y XSpeechSynthesizerGetStreamData para recuperar los datos de audio de la secuencia del sintetizador de voz. Use la función XSpeechSynthesizerCloseStreamHandle para cerrar la secuencia del sintetizador de voz después de haber recuperado los datos de audio. - El tamaño máximo de datos de una secuencia de sintetizador de voz es 0xffffffff bytes: cuatro gigabytes menos un byte. Se produce un error si intenta crear una secuencia de sintetizador de voz mayor que el tamaño máximo de datos.
- Para evitar pérdidas de memoria, llame a la función XSpeechSynthesizerCloseStreamHandle para cerrar un identificador de secuencia de sintetizador de voz después de haber completado todas las operaciones que usan el identificador. Todas las operaciones asincrónicas pendientes deben completarse antes de llamar a esta función.
- Para ver un ejemplo que muestra cómo usar la función XSpeechSynthesizerCreateStreamFromText, consulte XSpeechSynthesizerCreate.
Requisitos
Encabezado: XSpeechSynthesizer.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesDocumentación conceptual
Consulte también
XAccessibilityXSpeechSynthesizerCloseStreamHandle
XSpeechSynthesizer
