![]() |
GetIndVoice |
||||
Header: | SpeechSynthesis.h | Carbon status: | Supported | |
Obtains a voice specification structure for a voice by passing an index to the GetIndVoice function.
OSErr GetIndVoice ( SInt16 index, VoiceSpec *voice );
The index of the voice for which to obtain a voice specification structure. This number must range from 1 to the total number of voices, as returned by the CountVoices function.
A pointer to the voice specification structure whose fields are to be filled in.
A result code.
The GetIndVoice function returns, in the voice specification structure pointed to by the voice parameter, a specification of the voice whose index is provided in the index parameter. Your application should make no assumptions about the order in which voices are indexed.
Your application should not add, remove, or modify a voice and then call the GetIndVoice function with an index value other than 1. To allow the Speech Manager to update its information about voices, your application should always either call the CountVoices function or call the GetIndVoice function with an index value of 1 after adding, removing, or modifying a voice or after a time at which the user might have done so.
If you specify an index value beyond the number of available voices, the GetIndVoice function returns a voiceNotFound error.
Because the GetIndVoice function moves memory, you should not call it at interrupt time.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)