DisposeMovieTrack
The DisposeMovieTrack function removes a track from a movie.
pascal void DisposeMovieTrack (Track theTrack);
theTrack
- Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as
NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).
DESCRIPTION
When you remove a track from a movie, the Movie Toolbox also removes the corresponding media from the movie.
SPECIAL CONSIDERATIONS
Your application should not call this function as part of the process of disposing of a movie. When you dispose of a movie by calling the DisposeMovie function (described on page 2-83), the Movie Toolbox disposes of all the movie's tracks and their associated media structures.
ERROR CODES
| invalidTrack | -2009 | This track is corrupted or invalid |
| trackNotInMovie | -2030 | This track is not in this movie |