BOOL mmpLoadFile(idMovie, lpszFileName, wOptions)
This function loads a movie file for playback and establishes playback options for the movie.
MMPID idMovie
Identifies the movie ID of the Movie Player instance.
LPSTR lpszFileName
Specifies the name or file handle of an RMMP-format movie file.
To specify a movie filename, pass a far pointer to a character buffer containing the DOS filename of the movie file.
To specify a file handle, set the high-order word to zero and set the low-order word to the file handle of an open file. If you specify a file handle, the file pointer must point to the beginning of the RMMP chunk (at the first byte of the “RIFF” chunk ID).
WORD wOptions
Specifies playback and load options. Use any combination of the following flags:
MMP_DRAW_FRAME
Draw the first frame to the stage window. By default, the Movie Player does not display the first frame.
MMP_ERASE_FRAME
Erase the stage window before loading the movie file.
MMP_LOAD_REFERENCED
Load only those cast members that are referenced in the score. Using this flag can reduce memory requirements for movie files containing unused cast members. Default setting is to load all cast members contained in the movie file.
MMP_LOAD_NOBUFFER
Create no off-screen buffer for imaging movie frames. Use this flag in low-memory situations. Default setting is to create the off-screen buffer. Some movies require the use of the off-screen buffer.
MMP_LOAD_NOSTATIC
Reduce the system colors to black and white, leaving up to 254 colors for Movie Player use. When the stage window is the active window in the system, the Windows color scheme switches to black and white. Default setting is to reserve the 20 system colors, leaving up to 236 colors for Movie Player use.
Returns TRUE if operation successful, otherwise returns FALSE.
If the Movie Player is playing a movie file when this function is called, it stops animation and frees the currently loaded file before attempting to load the new movie file.
System color scheme changes caused by calling mmpLoadFile with the MMP_LOAD_NOSTATIC flag are canceled when the movie file is unloaded, when the stage window is inactive, and when the stage window is closed.
mmpFreeFile, mmpFileLoaded