IAMMediaContent Interface

Microsoft DirectShow 9.0

IAMMediaContent Interface

The IAMMediaContent interface retrieves metadata from a stream. Applications can use this interface to retrieve information encoded into a stream, such as the author, title, and copyright. This interface is exposed by the AVI Splitter filter and the MPEG-1 Stream Splitter filter.

Depending on the stream type, a filter might support a subset of the methods on this interface. For example, the AVI Splitter retrieves the copyright, author name, and title from INFO chunks in the AVI file. The remaining methods return E_NOTIMPL.

• Note   Windows Media Player does not use this interface to display metadata.

In addition to the methods inherited from IDispatch, the IAMMediaContent interface exposes the following methods.

Method	Description
get_AuthorName	Retrieves the author name.
get_Title	Retrieves the title.
get_Rating	Retrieves the rating.
get_Description	Retrieves a description of the content.
get_Copyright	Retrieves copyright information.
get_BaseURL	Retrieves a base URL for the related Web content.
get_LogoURL	Retrieves a URL for the logo.
get_LogoIconURL	Retrieves a URL for the logo icon.
get_WatermarkURL	Retrieves a URL for the watermark.
get_MoreInfoURL	Retrieves a URL for additional information about the content.
get_MoreInfoBannerImage	Retrieves an image for a related-information banner.
get_MoreInfoBannerURL	Retrieves a URL for a related-information banner.
get_MoreInfoText	Retrieves additional information as text.

Requirements

Header: Include Qnetwork.h.

Library: None.

To define the interface identifier, include the header file Initguid.h before Qnetwork.h, but after Dshow.h and other header files:

#include <dshow.h>
#include <initguid.h>
#include <qnetwork.h>

• Note   Make sure that Initguid.h is included only once in your project. Otherwise, you will receive linker errors for duplicate GUID values.