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
