IMFVideoMediaType::GetVideoRepresentation method (mfobjects.h)

[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.

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

See also

IMFVideoMediaType

Media Types