TextToSpeechAddBuffer

The TextToSpeechAddBuffer call supplies a memory buffer to the text-to-speech system. This memory buffer is used to store speech samples while in the speech-to-memory mode.

Syntax

MMRESULT TextToSpeechAddBuffer

(LPTTS_HANDLE_T phTTS,
LPTTS_BUFFER_T pTTSbuffer
)

Parameters

LPTTS_HANDLE_T phTTS

Specifies a text-to-speech handle.

 

LPTTS_BUFFER_T pTTSbuffer

Points to a structure containing the memory buffers. Buffers are supplied by the application to be used while in speech-to-memory mode.

Return Value

This call returns a value of type MMRESULT. The value is zero if the call is successful. The return value is one of the following constants:

Constant

Description

MMSYSERR_NOERROR

Normal successful completion (zero).

MMSYSERR_INVALPARAM

Invalid parameter.

MMSYSERR_ERROR

Output to memory not enabled or unable to create a system object.

MMSYSERR_INVALHANDLE

The text-to-speech handle was invalid.

 

 

Comments

The application must call TextToSpeechOpenInMemory before calling TextToSpeechAddBuffer. The memory buffer is passed using the TTS_BUFFER_T structure. The user must allocate the structure and its associated elements (memory buffer, phoneme array and index mark array).

btn_mini.gif Click here to go to the Speech-to-Memory Mode section for more information on the TTS_BUFFER_T structure and its elements.

The text-to-speech system returns the buffer to the application when the memory buffer, phoneme array, or index mark array is full or when a TTS_FORCE flag was used in the TextToSpeechSpeak call.

btn_mini.gif Click here to go to the Callback Routines and Window Procedures section for detail information on passing information back to the calling application.

 

 

See Also

btn_mini.gif Callback Routines and Window Procedures

btn_mini.gif Speech-To-Memory Mode

btn_mini.gif TextToSpeechOpenInMemory

btn_mini.gif TextToSpeechReturnBuffer

btn_mini.gif TextToSpeechStartup (UNIX only)

btn_mini.gif TextToSpeechStartup (Windows only)

btn_mini.gif TextToSpeechStartupEx