GetMovieTrack
The GetMovieTrack function allows your application to determine the track identifier of a track given the track's ID value.
pascal Track GetMovieTrack (Movie theMovie, long trackID);
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).
trackID
- Specifies the ID value of the track for this operation.
DESCRIPTION
The GetMovieTrack function returns the track identifier that is appropriate to the specified track. If the function cannot locate the track, it sets this returned value to nil.
ERROR CODES
| invalidMovie | -2010 | This movie is corrupted or invalid |
| trackIDNotFound | -2029 | Cannot locate a track with this ID value |
SEE ALSO
You can obtain a track's ID value by calling the GetTrackID function, which is described in the next section. You can use a track's index value to obtain its track identifier by calling the GetMovieIndTrack function, which is described in the previous section.
