contents.gifindex.gifprev1.gifnext1.gif

TextToSpeechSetSpeaker

The TextToSpeechSetSpeaker call sets the voice of the speaker the text-to-speech system will use.

Syntax
MMRESULT TextToSpeechSetSpeaker
(LPTTS_HANDLE_T phTTS, SPEAKER_T Speaker)
Parameters
LPTTS_HANDLE_T phTTS
Specifies a text-to-speech handle.

SPEAKER_T Speaker
Selects a speaker from the following list. These values are defined in include file ttsapi.h
Speaker
Description
PAUL
Default (male) voice
HARRY
Full male voice
FRANK
Aged male voice
DENNIS
Male voice
BETTY
Full female voice
URSULA
Aged female voice
WENDY
Whispering female voice
RITA
Female voice
KIT
Childs voice


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 was passed.
MMSYSERR_INVALHANDLE
The text-to-speech handle was invalid.


Comments
The change in speaking voice is not effective until the next phrase boundary. All queued audio encountered before the phrase boundary is unaffected.
See Also
TextToSpeechGetSpeaker