MFCreateVideoMediaTypeFromVideoInfoHeader2 function (mfapi.h)

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

See also

Media Foundation Functions

Media Types