# 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). 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. 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 | Callback Routines and Window Procedures Speech-To-Memory Mode TextToSpeechOpenInMemory TextToSpeechReturnBuffer TextToSpeechStartup (UNIX only) TextToSpeechStartup (Windows only) TextToSpeechStartupEx