mvNumMoviesHint(3dm)                                      mvNumMoviesHint(3dm)


NAME
     mvSetNumMoviesHint, mvGetNumMoviesHint - Advise Movie Playback Library of
     number of simultaneously-playing movies


SYNOPSIS
     #include <dmedia/movieplay.h>


     DMstatus mvSetNumMoviesHint(int nummovies);

     int mvGetNumMoviesHint(void);


DESCRIPTION
     mvSetNumMoviesHint(3dm) advises the Movie Playback Library of the number
     of movie instances which you are likely to ever play back at once.  If
     possible, this hint is used by the Movie Playback Library to properly
     allocate internal system resources.

     mvSetNumMoviesHint(3dm), if used, must be called before any other Movie
     Playback Library function.

     mvGetNumMoviesHint(3dm) returns the number of movies which the Movie
     Playback Library is likely to be able to play at once.  This number is
     not a guarantee.  You should always check the return value of
     mvBindOpenGLWindow(3dm) to determine if the Movie Playback Library is
     able to play back a particular movie.

     mvSetNumMoviesHint(3dm) returns DM_SUCCESS upon success, DM_FAILURE in
     the event of an error. If an error occurs, you may obtain a code
     describing the error by calling mvGetErrno(3dm).


SEE ALSO
     mvGetErrno(3dm), mvIntro(3dm), mvBindOpenGLWindow(3dm).


                                                                        Page 1