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

Chapter 19 - Error Manager

Summary of the Error Manager

C Summary

Data Types

typedef long                                 TQ3Error;
typedef long                                 TQ3Warning;
typedef long                                 TQ3Notice;

Error Manager Routines

Registering Error, Warning, and Notice Callback Routines

TQ3Status Q3Error_Register(TQ3ErrorMethod errorPost, long reference);
TQ3Status Q3Warning_Register(TQ3WarningMethod warningPost, long reference);
TQ3Status Q3Notice_Register(TQ3NoticeMethod noticePost, long reference);

Determining Whether an Error is Fatal

TQ3Boolean Q3Error_IsFatalError (
TQ3Error error);

Getting Errors, Warnings, and Notices Directly

TQ3Error Q3Error_Get(TQ3Error *firstError);
TQ3Warning Q3Warning_Get(TQ3Warning *firstWarning);
TQ3Notice Q3Notice_Get(TQ3Notice *firstNotice);

Getting Operating System Errors

OSErr Q3MacintoshError_Get(OSErr *firstMacErr);
int Q3UnixError_Get(int *firstUnixError);

Application-Defined Routines

typedef void (*TQ3ErrorMethod)(TQ3Error firstError, 
TQ3Error lastError, 
long reference);
typedef void (*TQ3WarningMethod) (
TQ3Warning firstWarning, 
TQ3Warning lastWarning, 
long reference);
typedef void (*TQ3NoticeMethod) (
TQ3Notice firstNotice, 
TQ3Notice lastNotice, 
long reference);

Errors

kQ3ErrorUnixError	A UNIX operating system error
kQ3ErrorMacintoshError	A Macintosh Operating System error