TextToSpeechSpeak

The TextToSpeechSpeak call queues a null-terminated string to the text-to-speech system. While in startup state, speech samples are routed to the audio device or ignored, depending on whether the DO_NOT_USE_AUDIO_DEVICE flag is set in the dwDeviceOptions parameter of the startup function. If the text_to_speech system is in one of its special modes (wave-file, log-file, or speech-to-memory modes), the speech samples are handled accordingly.

Syntax	MMRESULT TextToSpeechSpeak	(LPTTS_HANDLE_T phTTS, LPSTR pszTextString, DWORD dwFlags)
Parameters	LPTTS_HANDLE_T phTTS	Specifies a text-to-speech handle.
	LPSTR pszTextString	Points to a null terminated string of characters to be queued
	DWORD dwFlags	Specifies whether the text is to be pushed through the text-to-speech system even if it does NOT end on a clause boundary. It can be set to one of the following constants defined in include file ttsapi.h:
Constant			Description
TTS_NORMAL			Insert characters in the text-to-speech queue.
TTS_FORCE			Insert characters in the text-to-speech queue and force all text to be output even if the text stream does NOT end on a clause boundary.

Return Value	This call returns a value of type MMRESULT. The return 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 _NOMEM			Unable to allocate memory.
MMSYSERR_INVALHANDLE			The text-to-speech handle was invalid.

Comments	The speaker, speaking rate, and volume can also be changed in the text string by inserting in-line commands as shown in the following example: [:name paul] I am Paul. [:nb] I am Betty. [:volume set 50] The volume has been set to 50% of the maximum level. [:ra 120] I am speaking at 120 words per minute.
See Also	Special Speech-To-Text Modes TextToSpeechOpenInMemory TextToSpeechOpenLogFile TextToSpeechOpenWaveOutFile TextToSpeechStartup (UNIX) TextToSpeechStartup (Windows) TextToSpeechStartupEx