mmpOpen

Syntax

MMPID mmpOpen(hWndStage, wOptions)

This function initializes a Movie Player instance.

Parameters

HWND hWndStage

Specifies a handle to the window to be used as the stage window. If hWndStage is NULL, you must supply a stage window handle (using mmpSetStage) before starting the animation.

WORD wOptions

Not used.

Return Value

Returns a Movie Player instance identifier (movie ID) if successful. If the Movie Player fails to start an instance, the function returns NULL.

Comments

Each instance of the Movie Player is identified by the unique movie ID returned from the call to mmpOpen. Most Movie Player APIs require the movie ID returned by this function.

The Movie Player supports up to eight instances system-wide. A single application can play multiple movies simultaneously by opening multiple Movie Player instances and saving the movie ID for each instance.

If mmpOpen fails, you can call mmpError with a NULL value for the movie ID to retrieve the error that occurred.

See Also

mmpClose, mmpError, mmpSetStage