MFCreateVideoMediaTypeFromVideoInfoHeader2 function (mfapi.h)

Article
02/22/2024

Creates a media type from a KS_VIDEOINFOHEADER2 structure.

Syntax

HRESULT MFCreateVideoMediaTypeFromVideoInfoHeader2(
  const KS_VIDEOINFOHEADER2 *pVideoInfoHeader,
  DWORD                     cbVideoInfoHeader,
  QWORD                     AdditionalVideoFlags,
  const GUID                *pSubtype,
  IMFVideoMediaType         **ppIVideoMediaType
);

Parameters

pVideoInfoHeader

Pointer to the KS_VIDEOINFOHEADER2 structure to convert. (This structure is identical to the DirectShow VIDEOINFOHEADER2 structure.)

cbVideoInfoHeader

Size of the KS_VIDEOINFOHEADER2 structure in bytes.

AdditionalVideoFlags

Bitwise OR of flags from the MFVideoFlags enumeration. Use this parameter for format information that is not contained in the KS_VIDEOINFOHEADER2 structure.

pSubtype

Pointer to a subtype GUID. This parameter can be NULL. If the subtype GUID is specified, the function uses it to set the media subtype. Otherwise, the function attempts to deduce the subtype from the biCompression field contained in the KS_VIDEOINFOHEADER2 structure.

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

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