IMFPMediaItem::GetPresentationAttribute method (mfplay.h)

Article
02/22/2024

Important Deprecated. This API may be removed from future releases of Windows. Applications should use the Media Session for playback.

Queries the media item for a presentation attribute.

Syntax

HRESULT GetPresentationAttribute(
  [in]  REFGUID     guidMFAttribute,
  [out] PROPVARIANT *pvValue
);

Parameters

[in] guidMFAttribute

GUID that identifies the attribute value to query.

For a list of presentation attributes, see Presentation Descriptor Attributes.

[out] pvValue

Pointer to a PROPVARIANT that receives the value. The method fills the PROPVARIANT with a copy of the stored value. Call PropVariantClear to free the memory allocated by the method.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Presentation attributes describe the presentation as a whole. To get an attribute that applies to an individual stream within the presentation, call IMFPMediaItem::GetStreamAttribute.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	mfplay.h