Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Saving Movies

PutMovieIntoHandle

The PutMovieIntoHandle function creates a new movie resource for you. You can use this handle to store a QuickTime movie in a specialized storage format.

pascal OSErr PutMovieIntoHandle (Movie theMovie,
                                 Handle publicMovie);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

publicMovie

Contains the handle that is to receive the new movie resource. The PutMovieIntoHandle function places the new movie resource into this handle. The function resizes the handle if necessary.

DESCRIPTION

Note that you cannot use this new movie with other Movie Toolbox functions, except for the NewMovieFromHandle function. You can use the NewMovieFromHandle function, described on page 2-78, to load a movie from a handle.

SPECIAL CONSIDERATIONS

Movies saved using PutMovieIntoHandle contain less robust data references than those created using the AddMovieResource or PutMovieIntoDataFork functions (described on page 2-90 and page 2-97, respectively).

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

Memory Manager errors

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help