Inside Macintosh: QuickTime Components /

Chapter 10 - Derived Media Handler Components / Derived Media Handler Components Reference

Functions / General Data Management

MediaGetMediaInfo

The MediaGetMediaInfo function allows your derived media handler to obtain the private data you have stored in your media.

pascal ComponentResult MediaGetMediaInfo (ComponentInstance ci,
                                           Handle h);

ci

Identifies the Movie Toolbox's connection to your derived media handler.

h

Contains a handle to storage containing your media handler's proprietary information. Your media handler creates this private data when the Movie Toolbox calls your MediaPutMediaInfo function. Do not dispose of this handle--it is owned by the Movie Toolbox.

DESCRIPTION

If you placed private data into your media, the Movie Toolbox calls your media handler's MediaPutMediaInfo function whenever it opens your media. Your
media handler determines the format and content of this private data. Note that the Movie Toolbox may call this function before it calls your MediaInitialize function.

Your derived media handler should support this function if you store private data
in your media.

RESULT CODES

Any Component Manager result code