The TextToSpeechOpenWaveOutFile call causes the specified wave file to be opened and the text-to-speech system to enter into wave-file mode. This mode indicates that the speech samples are to be written in wave format into the wave file each time TextToSpeechSpeak is called. The text-to-speech system remains in the wave-file mode until TextToSpeechCloseWaveOutFile is called
Syntax |
MMRESULT TextToSpeechOpenWaveOutFile |
(LPTTS_HANDLE_T phTTS, | ||
Parameters |
LPTTS_HANDLE_T phTTS |
Specifies a text-to-speech handle. | ||
|
LPSTR pszFileName |
Specifies a pointer to a file name. | ||
|
DWORD dwFormat |
Determines the audio sample format. It can be one of the following constants that are defined in include files mmsystem.h and ttsapi.h: | ||
Constant |
Description | |||
Mono 8-bit, 11.025 kHz sample rate | ||||
Mono 16-bit, 11.025 kHz sample rate | ||||
Mono 8-bit, m-law 8 kHz sample rate | ||||
|
| |||
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_INVALPARAM |
An invalid parameter or an illegal wave output format was passed. | |||
MMSYSERR_NOMEM |
Memory allocation error. | |||
MMSYSERR_ALLOCATED |
A wave file is already open. | |||
MMSYSERR_ERROR |
Unable to open the wave file or unable to write to the wave file. | |||
MMSYSERR_INVALHANDLE |
The text-to-speech handle was invalid. | |||
|
| |||
Comments |
This call automatically resumes audio output if the text-to-speech system is in a paused state by a previously issued TextToSpeechPause call. The startup function must be called to start the text-to-speech system before calling TextToSpeechOpenWaveOutFile. | |||
See Also |