SetMoviesErrorProc
The Movie Toolbox allows applications to perform custom error notification. Your application must identify its custom error-notification function to the Movie Toolbox. The SetMoviesErrorProc function allows you to identify your application's error-notification function. Error-notification functions can be especially useful when you are debugging your program.
pascal void SetMoviesErrorProc (ErrorProcPtr errProc,
long refcon);
errProcPtr
-
Points to your error-notification function, MyErrProc.
-
- The entry point to your error-notification function must take the following form:
pascal void MyErrProc (OSErr theErr, long refCon);
-
- See "Application-Defined Functions" beginning on page 2-332 for details on the parameters.
refcon
- Contains a reference constant value. The Movie Toolbox passes this reference constant to your error-notification function each time it calls your function.
DESCRIPTION
Once you have identified an error-notification function, the Movie Toolbox calls your function each time the current error value is to be set to a nonzero value. The Movie Toolbox manages the sticky error value. The Movie Toolbox calls your error-notification function only in response to errors generated by the Movie Toolbox.
SPECIAL CONSIDERATIONS
The SetMoviesErrorProc function is just for debugging.
ERROR CODES
None
