Structure

SpeechErrorInfo

Defines a speech error information structure.

Declaration

typedef struct SpeechErrorInfo {
    ...
} SpeechErrorInfo;

Overview

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

Speech error information structures never include errors that are returned by Speech Synthesis 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.

Topics

Instance Properties

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.

newPos

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

newest

The error code of the most recent error.

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.

oldest

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