IMFMetadataProvider::GetMFMetadata method

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

pPresentationDescriptor [in]

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

dwStreamIdentifier [in]

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.

dwFlags [in]

Reserved. Must be zero.

ppMFMetadata [out]

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 codeDescription
S_OK

The method succeeded.

MF_E_PROPERTY_NOT_FOUND

No metadata is available for the requested stream or presentation.

 

Requirements

Minimum supported client

Windows Vista [desktop apps | UWP apps]

Minimum supported server

Windows Server 2008 [desktop apps | UWP apps]

Header

Mfidl.h

Library

Mfuuid.lib

See also

IMFMetadataProvider
Media Metadata

 

 

Show: