Carbon


MakeVoiceSpec

Header: SpeechSynthesis.h Carbon status: Supported

Sets the fields of a voice specification structure.

OSErr MakeVoiceSpec (
    OSType creator, 
    OSType id, 
    VoiceSpec *voice
);
Parameter descriptions
creator

The ID of the synthesizer that your application requires.

id

The ID of the voice on the synthesizer specified by the creator parameter.

voice

A pointer to the voice specification structure whose fields are to be filled in.

function result

A result code.

DISCUSSION

A voice specification structure is a unique voice ID used by the Speech Manager. Most voice management functions expect to be passed a pointer to a voice specification structure. When you already know the creator and ID for a voice, you should use the MakeVoiceSpec function to create such a structure rather than filling in the fields of one directly. On exit, the voice specification structure pointed to by the voice parameter contains the appropriate values. You should never set the fields of such a structure directly.

SPECIAL CONSIDERATIONS

You can call the MakeVoiceSpec function 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)