IMFVideoMediaType::GetVideoRepresentation method (mfobjects.h)

Article
02/22/2024

[This API is not supported and may be altered or unavailable in the future. Instead, applications should set the MF_MT_DEFAULT_STRIDE attribute on the media type to specify the surface stride and then call IMFMediaType::GetRepresentation.]

Retrieves an alternative representation of the media type.

Syntax

HRESULT GetVideoRepresentation(
  [in]  GUID   guidRepresentation,
  [out] LPVOID *ppvRepresentation,
  [in]  LONG   lStride
);

Parameters

[in] guidRepresentation

GUID that specifies the representation to retrieve. For a list of values, see IMFMediaType::GetRepresentation.

[out] ppvRepresentation

Receives a pointer to a structure that contains the representation. The method allocates the memory for the structure. The caller must release the memory by calling IMFMediaType::FreeRepresentation.

[in] lStride

Stride of the video surface, in bytes. If the stride is unknown, set this value to 0. If the value is 0, the method computes the stride from the image width and assumes that there is no padding.

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.

Remarks

This method is equivalent to IMFMediaType::GetRepresentation but includes the lStride parameter.

Instead of calling this method, applications should set the MF_MT_DEFAULT_STRIDE attribute on the media type to specify the surface stride and then call IMFMediaType::GetRepresentation.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	mfobjects.h (include Mfidl.h)
Library	Mfuuid.lib