Carbon


SpeechErrorInfo

Header: SpeechSynthesis.h

struct SpeechErrorInfo {
    SInt16 count; 
    OSErr oldest; 
    SInt32 oldPos; 
    OSErr newest; 
    SInt32 newPos;
};

Field descriptions

count

The number of errors that have occurred in processing the current text buffer since the last call to the GetSpeechInfo function with the soErrors selector. Of these errors, you can find information about only the first and last error that occurred.

oldest

The error code of the first error that occurred after the previous call to the GetSpeechInfo function with the soErrors selector.

oldPos

The character position within the text buffer being processed of the first error that occurred after the previous call to the GetSpeechInfo function with the soErrors selector.

newest

The error code of the most recent error.

newPos

The character position within the text buffer being processed of the most recent error.

By calling the GetSpeechInfo function with the soErrors selector, you can obtain a speech error information structure, which shows what Speech Manager errors occurred while processing a text buffer on a given speech channel. The SpeechErrorInfo data type defines a speech error information structure.

Speech error information structures never include errors that are returned by Speech Manager functions. Instead, they reflect only errors encountered directly in the processing of text, and, in particular, in the processing of commands embedded within text.

The speech error information structure keeps track of only the most recent error and the first error that occurred after the previous call to the GetSpeechInfo function with the soErrors selector. If your application needs to keep track of all errors, then you should install an error callback function, SpeechErrorProcPtr.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)