TtsGetVoiceList

Get the list of installed Vocalizer voices and their properties.

TTSRETVAL TtsGetVoiceList (
 TTS_VOICE_INFO * pVoiceList,
 LH_U16 * pu16VoiceList);

Argument

Description

pVoiceList

[out] Pointer to an array of TTS_VOICE_INFO structures that will be filled with information about the available voices. This may be set to NULL to query the number of installed voices.

pu16VoiceList

[in] On input, this must indicate the number of TTS_VOICE_INFO structures allocated for pVoiceList.

[out] On output, this is set to the actual number of TTS_VOICE_INFO structures filled in pVoiceList, or if pVoiceList is NULL, this is set to the total number of installed voices.

The TtsGetVoiceList function for retrieving all the installed voices does not trigger an installed voice rescan. However, once a rescan is initiated by a request for voice criteria that cannot be met, TtsGetVoiceList returns a full list of voices that includes all the original voices plus all the new voices found by the rescan (not necessarily just the one specified by the application’s voice criteria).