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