Edit

Share via

IMFMetadataProvider::GetMFMetadata method (mfidl.h)

  • Article

Gets a collection of metadata, either for an entire presentation, or for one stream in the presentation.

Syntax

HRESULT GetMFMetadata(
  [in]  IMFPresentationDescriptor *pPresentationDescriptor,
  [in]  DWORD                     dwStreamIdentifier,
  [in]  DWORD                     dwFlags,
  [out] IMFMetadata               **ppMFMetadata
);

Parameters

[in] pPresentationDescriptor

Pointer to the IMFPresentationDescriptor interface of the media source's presentation descriptor.

[in] dwStreamIdentifier

If this parameter is zero, the method retrieves metadata that applies to the entire presentation. Otherwise, this parameter specifies a stream identifier, and the method retrieves metadata for that stream. To get the stream identifier for a stream, call IMFStreamDescriptor::GetStreamIdentifier.

[in] dwFlags

Reserved. Must be zero.

[out] ppMFMetadata

Receives a pointer to the IMFMetadata interface. Use this interface to access the metadata. The caller must release the interface.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
 The method succeeded.
MF_E_PROPERTY_NOT_FOUND
 No metadata is available for the requested stream or presentation.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See also

IMFMetadataProvider

Media Metadata