saiTtsGetVoice

Retrieves speaker voice characteristics based on Speech Synthesis Markup Language (SSML) specifications.

Prototype

DWORD saiTtsGetVoice ( SAI_SYNTHESIZER_HANDLE synthHd, SAI_VOICE *value )

Argument

Description

synthHd

Handle associated with a synthesizer resource.

value

Pointer to the SAI_VOICE structure that specifies the speaker voice attribute:

typedef struct
{
   SAI_VOICE_GENDER     gender;
   INT32                age;
   char                 variant[SAI_MAX_STRINGLENGTH];
   char                 name[SAI_MAX_STRINGLENGTH];
}
SAI_VOICE;

For more information, refer to SAI_VOICE. For information about speaker attributes, refer to the SSML specification and to the vendor documentation.


Return values

Return value

Description

SUCCESS

 

SAIERR_INVALID_PARAMETER

One of the specified arguments is invalid.

SAIERR_UNSUPPORTED_SPEECH_PARAMETER

Speech engine does not support the specified parameter.


See also

saiTtsSetVoice