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

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