Inside Macintosh: QuickTime Components /

Chapter 2 - Movie Controller Components / Movie Controller Components Reference

Movie Controller Functions / Handling Movie Events

MCDoAction

Your application can use the MCDoAction function to invoke a movie controller component and have it perform a specified action.

pascal ComponentResult MCDoAction (MovieController mc, 
                                    short action, void *params;

mc

Specifies the movie controller for the operation. You obtain this
identifier from the Component Manager's OpenComponent or OpenDefaultComponent function, or from the NewMovieController function.

action

Specifies the action to be taken. See "Movie Controller Actions," which begins on page 2-15, for descriptions of the actions supported by movie controller components.

params

Points to the parameter data appropriate to the action. See the individual action descriptions in "Movie Controller Actions," which begins on page 2-15, for information about the parameters required for each supported action.

DESCRIPTION

For example, your application might define a menu item that stops all currently playing movies. When the user selects this menu item, your application could use the MCDoAction function to instruct each controller to stop playing. You would do so by specifying an mcActionPlay action with the parameters set to 0 to indicate that the controller should stop playing the movie.