Inside Macintosh: Sound /

Chapter 4 - Speech Manager / Speech Manager Reference

Speech Manager Routines / Obtaining Information About Voices

MakeVoiceSpec

To set the fields of a voice specification record, you should use the MakeVoiceSpec function. You should never set the fields of such a record directly.

FUNCTION MakeVoiceSpec (creator: OSType; id: OSType; 
                           voice: VoiceSpecPtr): OSErr;

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 record whose fields are to be filled in.

DESCRIPTION

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

SPECIAL CONSIDERATIONS

You can call the MakeVoiceSpec function at interrupt time.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the MakeVoiceSpec function are

Trap macro	Selector
_SoundDispatch	$0604000C

RESULT CODES

noErr

0

No error