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

Child’s 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

btn_mini.gif TextToSpeechGetSpeaker