IAMMediaContent Interface

  • Article
 
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.