mvNumMoviesHint(3dm)					  mvNumMoviesHint(3dm)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/movieplay.h>


     DMstatus mvSetNumMoviesHint(int nummovies);

     int mvGetNumMoviesHint(void);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

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


									PPPPaaaaggggeeee 1111