GetMediaDataHandler
The GetMediaDataHandler function allows you to determine a media's data handler.
pascal DataHandler GetMediaDataHandler (Media theMedia,
short index);
theMedia
- Specifies the media for this operation. Your application obtains this media identifier from such Movie Toolbox functions as
NewTrackMedia and GetTrackMedia (described on page 2-138 and page 2-190, respectively).
index
- Identifies the data reference. You provide the index value that corresponds to the data reference for which you want to retrieve the data handler. You must set this parameter to 1.
DESCRIPTION
The GetMediaDataHandler function returns a data handler identifier. This identifier is a component instance that specifies a connection to a data handler component (see the chapter "Component Manager" in Inside Macintosh: More Macintosh Toolbox for more information about components). If the Movie Toolbox cannot determine the data handler for the media you specify, the function sets this returned value to nil.
- Note
- Your application should not need to call this function.
ERROR CODES
| invalidMedia | -2008 | This media is corrupted or invalid |
