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).