Carbon


SetSpeechInfo

Header: SpeechSynthesis.h Carbon status: Supported

Changes a setting of a particular speech channel.

OSErr SetSpeechInfo (
    SpeechChannel chan, 
    OSType selector, 
    const void *speechInfo
);
Parameter descriptions
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.

For a complete list of speech information selectors, see “Speech Information Constants”. 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.

speechInfo

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

function result

A result code.

DISCUSSION

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.

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)