IMFSourceReader::GetPresentationAttribute method

Gets an attribute from the underlying media source.

Syntax

HRESULT GetPresentationAttribute(
  DWORD       dwStreamIndex,
  REFGUID     guidAttribute,
  PROPVARIANT *pvarAttribute
);

Parameters

dwStreamIndex

The stream or object to query. The value can be any of the following.

Value Meaning
0–0xFFFFFFFB
The zero-based index of a stream.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
The first video stream.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
The first audio stream.
MF_SOURCE_READER_MEDIASOURCE
0xFFFFFFFF
The media source.

guidAttribute

A GUID that identifies the attribute to retrieve. If the dwStreamIndex parameter equals MF_SOURCE_READER_MEDIASOURCE, guidAttribute can specify one of the following:

Otherwise, if the dwStreamIndex parameter specifies a stream, guidAttribute specifies a stream descriptor attribute. For a list of values, see Stream Descriptor Attributes.

pvarAttribute

A pointer to a PROPVARIANT that receives the value of the attribute. Call the PropVariantClear function to free the PROPVARIANT.

Return Value

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

Remarks

This interface is available on Windows Vista if Platform Update Supplement for Windows Vista is installed.

Requirements

   
Windows version Windows 7, Windows Vista and Platform Update Supplement for Windows Vista [desktop apps | UWP apps] Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header mfreadwrite.h

See Also

IMFSourceReader

Media Foundation Attributes

Source Reader