![]() |
NewSpeechChannel |
||||
Header: | SpeechSynthesis.h | Carbon status: | Supported | |
Creates a new speech channel.
OSErr NewSpeechChannel ( VoiceSpec *voice, SpeechChannel *chan );
A pointer to the voice specification structure corresponding to the voice to be used for the new speech channel. Pass NULL to create a speech channel using the system default voice.
On return, a pointer to a valid speech channel.
A result code.
The NewSpeechChannel function allocates memory for a speech channel structure and sets the speech channel variable pointed to by the chan parameter to point to this speech channel structure. The Speech Manager automatically locates and opens a connection to the proper synthesizer for the voice specified by the voice parameter.
There is no predefined limit to the number of speech channels an application can create. However, system constraints on available RAM, processor loading, and number of available sound channels limit the number of speech channels actually possible.
Your application should not attempt to manipulate the data pointed to by a variable of type SpeechChannel. The internal format that the Speech Manager uses for speech channel data is not documented and may change in future versions of system software.
Because the NewSpeechChannel function allocates 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)