Starting and Stopping Playback

The mmpStartAnimating function notifies the Movie Player that playback is to start. This function has the following syntax:

BOOL mmpStartAnimating(idMovie, wOptions)

Pass a valid movie ID to idMovie. You can pass the MMP_DRAW_FRAME flag to the wOptions parameter to display the next frame in the stage window. This function returns FALSE if the movie is already running; TRUE if it succeeds in starting animation.

The Movie Player automatically stops playback when it reaches the last frame in a movie. You can call mmpStopAnimating to stop playback before the end of the movie. This function has the following syntax:

BOOL mmpStopAnimating(idMovie, wOptions)

If you set the MMP_DRAW_FRAME flag in the wOptions parameter, the Movie Player displays the next frame before stopping the movie. This function returns FALSE if the movie isn't running. If it succeeds in stopping animation, it returns TRUE.

You can call mmpStartAnimating and mmpStopAnimating functions anytime after the Movie Player is open and a movie file is loaded. Use these functions as pause and resume controls for the Movie Player.