Inside Macintosh: Sound /

Chapter 4 - Speech Manager / Speech Manager Reference

Speech Manager Routines / Changing Speech Attributes

SetSpeechInfo

You can use the SetSpeechInfo function to change a setting of a particular speech channel.

FUNCTION SetSpeechInfo (chan: SpeechChannel; selector: OSType;
                        speechInfo: Ptr): OSErr;

chan

The speech channel for which your application wishes to change a setting.

selector

A speech information selector that indicates the type of information being changed.

speechInfo

A pointer whose meaning depends on the speech information selector specified in the selector parameter.

DESCRIPTION

The SetSpeechInfo function changes the type of setting indicated by the selector parameter in the speech channel specified by the chan parameter, based on the data your application provides via the speechInfo parameter.

The format of the data structure specified by the speechInfo parameter depends on the selector you choose. Ordinarily, a selector requires that speechInfo be a pointer to a data structure that specifies a new setting for the speech channel.

SPECIAL CONSIDERATIONS

You can call the SetSpeechInfo function at interrupt time only if the speech information selector specified in the selector parameter does not move or purge memory.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the SetSpeechInfo function are

Trap macro	Selector
_SoundDispatch	$0654000C

RESULT CODES

noErr	0	No error
paramErr	-50	Parameter value is invalid
siUnknownInfoType	-231	Feature is not implemented on synthesizer
incompatibleVoice	-245	Specified voice cannot be used with synthesizer
invalidComponentID	-3000	Speech channel is uninitialized or bad

SEE ALSO

For a complete list of speech information selectors, see "Speech Information Selectors" beginning on page 4-39. This list indicates how your application should set the speechInfo parameter for each selector and indicates which selectors might cause memory to be moved or purged.