mvGetErrno(3dm)                                                mvGetErrno(3dm)


NAME
     mvGetErrno, mvClearErrno, mvGetErrorStr - return information for Movie
     Library error codes


SYNOPSIS
     #include <dmedia/moviefile.h>


     int mvGetErrno();

     const char* mvGetErrorStr(int error);

     void mvClearErrno(void);


DESCRIPTION
     function that returned an error (DM_FAILURE).

     mvGetErrorStr(3dm) returns an error string corresponding to error.

     mvClearErrno(3dm) sets the error code stored in the Movie Library to
     zero.

     If the value of dmGetErrno(3dm) does not match one of the error codes
     outlined in moviefile.h, it will match one of the system error codes
     outlined in <sys/errno.h>.

     Besides error codes which are returned by Movie Library function calls,
     errors encountered while playing a movie are sent to the client
     application via the Movie Library event queue.  In that case, the value
     of the error code contained in the event corresponds to the error codes
     listed in moviefile.h, and may be passed to mvGetErrorStr(3dm) to receive
     a valid error string.  See the manual page for mvNextEvent(3dm).


SEE ALSO
     mvIntro(3dm), mvNextEvent(3dm).


                                                                        Page 1