ALseterrorhandler(3dm)ALseterrorhandler(3dm)NAMEALseterrorhandler - (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*, ...)
DESCRIPTIONALseterrorhandler 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 */
...
Page 1
ALseterrorhandler(3dm)ALseterrorhandler(3dm)SEE ALSOstdarg(5)
Page 2
