Function

GetSpeechInfo

Gets information about a designated speech channel.

Declaration

OSErr GetSpeechInfo(SpeechChannel chan, OSType selector, void *speechInfo);

Parameters

chan

The speech channel about which information is being requested.

selector

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

For a complete list of speech information selectors, see Speech-Channel Information Constants. This list indicates how your application should set the speechInfo parameter for each selector.

speechInfo

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

Return Value

A result code. See Result Codes.

Discussion

The GetSpeechInfo function returns, in the data structure pointed to by the speechInfo parameter, the type of information requested by the selector parameter as it applies to the speech channel specified in the chan parameter.

The format of the data structure specified by the speechInfo parameter depends on the selector you choose. For example, a selector might require that your application allocate a block of memory of a certain size and pass a pointer to that block. Another selector might require that speechInfo be set to the address of a handle variable. In this case, the GetSpeechInfo function would allocate a relocatable block of memory and change the handle variable specified to reference the block.

See Also

Obtaining Information About Speech and Speech Channels

CopySpeechProperty

Gets the value associated with the specified property of a speech channel.

GetSpeechPitch

Gets a speech channel’s current speech pitch.

GetSpeechRate

Gets a speech channel’s current speech rate.

SpeechBusy

Determines whether any channels of speech are currently synthesizing speech.

SpeechBusySystemWide

Determines if any speech is currently being synthesized in your application or elsewhere on the computer.

SpeechManagerVersion

Determines the current version of the Speech Synthesis Manager installed in the system.