GetMoviePreferredRate
The GetMoviePreferredRate function returns a movie's default playback rate. This is the rate that the StartMovie function uses when it starts playing a movie.
pascal Fixed GetMoviePreferredRate (Movie theMovie);
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).
DESCRIPTION
The GetMoviePreferredRate function returns the default movie rate as a 32-bit, fixed-point number. Positive integers indicate forward rates and negative integers indicate reverse rates.
ERROR CODES
| invalidMovie | -2010 | This movie is corrupted or invalid |
SEE ALSO
Your application can change the preferred playback rate by calling the SetMoviePreferredRate function, which is described in the previous section. You can change the current playback rate of a movie by calling the SetMovieRate function, which is described on page 2-172.
