ALseterrorhandler(3dm)

NAME
     ALseterrorhandler - (obsolete) establish an alternate audio error
     handling routine

SYNOPSIS
     #include <dmedia/audio.h>

     ALerrfunc ALseterrorhandler(ALerrfunc efunc)

PARAMETER
     efunc       expects a pointer to an error handling routine declared as
                 void errorfunc(long, const char*, ...)

DESCRIPTION
     ALseterrorhandler is obsolete and is provided for backward compatibility.
     The preferred function is alSetErrorHandler(3dm).  Note that the default
     error handler is now none; you must call alSetErrorHandler to establish
     one.

     The Audio Library provides a default error handling routine which prints
     diagnostic messages whenever an error occurs in a library call.

     ALseterrorhandler(3dm) allows you to override the default error handling
     routine.

     The arguments that are passed to the error handling routine are an error
     code and a printf-like string perhaps followed with printf-like
     arguments.

     The returned value is a pointer to the previous error handling routine.

     Setting efunc to 0 prevents any error handling routine from being called;
     in this case, the application should check for errors by examining the AL
     function return values.  Unless printed warnings are desired, we
     recommend disabling the error handling function and testing for errors
     within the application.

EXAMPLE
               #include <dmedia/audio.h>
               ALerrfunc originalErrorHandler;
               ...

               originalErrorHandler = ALseterrorhandler(0);
               /* AL errors here will go unnoticed */
               ...

               ALseterrorhandler(originalErrorHandler);
               /* back to normal reporting of AL errors */

               ...
SEE ALSO
     stdarg(5)