IAMMediaContent interface (qnetwork.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

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.
 

Inheritance

The IAMMediaContent interface inherits from the IDispatch interface. IAMMediaContent also has these types of members:

Methods

The IAMMediaContent interface has these methods.

 
IAMMediaContent::get_AuthorName

The get_AuthorName method retrieves the author name.
IAMMediaContent::get_BaseURL

The get_BaseURL method gets a base URL for the related web content.
IAMMediaContent::get_Copyright

The get_Copyright method retrieves copyright information.
IAMMediaContent::get_Description

The get_Description method retrieves a description of the content.
IAMMediaContent::get_LogoIconURL

The get_LogoIconURL method retrieves a URL for the logo icon.
IAMMediaContent::get_LogoURL

The get_LogoURL method retrieves a URL for the logo.
IAMMediaContent::get_MoreInfoBannerImage

The get_MoreInfoBannerImage method retrieves an image for a related-information banner.
IAMMediaContent::get_MoreInfoBannerURL

The get_MoreInfoBannerURL method retrieves a URL for a related-information banner.
IAMMediaContent::get_MoreInfoText

The get_MoreInfoText method retrieves additional information as text.
IAMMediaContent::get_MoreInfoURL

The get_MoreInfoURL method retrieves a URL for additional information about the content.
IAMMediaContent::get_Rating

The get_Rating method retrieves the rating.
IAMMediaContent::get_Title

The get_Title method retrieves the title.
IAMMediaContent::get_WatermarkURL

The get_WatermarkURL method retrieves a URL for the watermark.

Remarks

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.
 

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header qnetwork.h

See also

IDispatch