MFCreateVideoMediaType function (mfapi.h)

Article
02/22/2024

[This API is not supported and may be altered or unavailable in the future. Applications should avoid using the MFVIDEOFORMAT structure, and use media type attributes instead. For more information, see Video Media Types.]

Creates a video media type from an MFVIDEOFORMAT structure.

Syntax

HRESULT MFCreateVideoMediaType(
  [in]  const MFVIDEOFORMAT *pVideoFormat,
  [out] IMFVideoMediaType   **ppIVideoMediaType
);

Parameters

[in] pVideoFormat

Pointer to an MFVIDEOFORMAT structure that describes the video format.

[out] ppIVideoMediaType

Receives a pointer to the IMFVideoMediaType interface. The caller must release the interface.

Return value

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

Remarks

Instead of using the MFVIDEOFORMAT structure to initialize a video media type, you can call MFCreateMediaType and set the media type attributes directly.

Note Prior to Windows 7, this function was exported from evr.dll. Starting in Windows 7, this function is exported from mfplat.dll, and evr.dll exports a stub function that calls into mfplat.dll. For more information, see Library Changes in Windows 7.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	mfapi.h
Library	Evr.lib
DLL	Mfplat.dll