Carbon


NewSpeechChannel

Header: SpeechSynthesis.h Carbon status: Supported

Creates a new speech channel.

OSErr NewSpeechChannel (
    VoiceSpec *voice, 
    SpeechChannel *chan
);
Parameter descriptions
voice

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.

chan

On return, a pointer to a valid speech channel.

function result

A result code.

DISCUSSION

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.

SPECIAL CONSIDERATIONS

Because the NewSpeechChannel function allocates memory, you should not call it at interrupt time.

AVAILABILITY

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)