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

Requirement Value
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