Previous Book Contents Book Index Next

Inside Macintosh: Sound /
Chapter 4 - Speech Manager / Speech Manager Reference
Speech Manager Routines / Obtaining Information About Voices


Legacy Documentclose button

Important: Inside Macintosh: Sound is deprecated as of Mac OS X v10.5. For new audio development in Mac OS X, use Core Audio. See the Audio page in the ADC Reference Library.

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 macroSelector
_SoundDispatch$0604000C

RESULT CODES
noErr0No error

Previous Book Contents Book Index Next

© Apple Computer, Inc.
2 JUL 1996