Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 19 - Error Manager / Error Manager Reference

Application-Defined Routines /

TQ3ErrorMethod

You can define an error-handling function to handle errors that occur during the execution of QuickDraw 3D routines.

typedef void (*TQ3ErrorMethod) (
TQ3Error firstError, 
TQ3Error lastError, 
long reference);

firstError

A code that indicates the first error that occurred since the last time your error-handling function was called.

lastError

A code that indicates the most recent error that occurred.

reference

A long integer for your application's own use.

DESCRIPTION

Your TQ3ErrorMethod function is called whenever a QuickDraw 3D routine generates an error (fatal or otherwise) during its execution that QuickDraw 3D cannot handle internally. Your error-handling function should handle the error conditions indicated by the firstError and lastError parameters. If necessary, you can long jump out of your error method.

Your function must not call any QuickDraw 3D routines other than Q3Error_IsFatalError (which you can call to determine if the error was fatal). The reference parameter contains the long integer that you passed to Q3Error_Register when you registered your error handler. You can, for example, use that long integer to point to any data required by your error handler.