TtsProcessEx

Convert input text data into output speech.

Use the pSpeakData argument to describe the input data properties. (The output data has the previously specified output format.)

TTSRETVAL TtsProcessEx (
 HTTSINSTANCE hTtsInst,
 const TTS_SPEAK_DATA* pSpeakData)

Argument

Description

hTtsInst

[in] Handle to a TTS engine instance

pSpeakData

[in] Pointer to TTS_SPEAK_DATA typed structure, which describes where to find the input data for text to speech and its properties. For details, see TTS_SPEAK_DATA.

To use the source callback, specify NULL for the input members (uri and data) of the structure.

Error codes: This function can return licensing related errors. See Error codes.

This function uses the TTS_SPEAK_DATA structure to determine the TTS input method:

  1. If the uri member has a non-NULL value, use the specified URI.
  2. If the data member has a non-NULL value, use the specified buffer.
  3. If both uri and data are NULL, use the source callback function of type TTS_SOURCE_CB.