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 1552228 Speech Channel_information_constants. This list indicates how your application should set the
speechInfoparameter for each selector. - speechInfo:
A pointer whose meaning depends on the speech information selector specified in the
selectorparameter.
Return Value
A resultcode. See Result Codes.
Discussion
The GetSpeechInfo functionreturns, in the data structure pointed to by the speechInfo parameter,the type of information requested by the selector parameteras it applies to the speech channel specified in the chan parameter.
The format of the data structure specified by the speechInfo parameterdepends on the selector you choose. For example, a selector mightrequire that your application allocate a block of memory of a certainsize and pass a pointer to that block. Another selector might requirethat speechInfo be setto the address of a handle variable. In this case, the GetSpeechInfo functionwould allocate a relocatable block of memory and change the handlevariable specified to reference the block.