MFCreateVideoMediaTypeFromVideoInfoHeader function (mfapi.h)

Creates a media type from a KS_VIDEOINFOHEADER structure.

Syntax

HRESULT MFCreateVideoMediaTypeFromVideoInfoHeader(
  const KS_VIDEOINFOHEADER *pVideoInfoHeader,
  DWORD                    cbVideoInfoHeader,
  DWORD                    dwPixelAspectRatioX,
  DWORD                    dwPixelAspectRatioY,
  MFVideoInterlaceMode     InterlaceMode,
  QWORD                    VideoFlags,
  const GUID               *pSubtype,
  IMFVideoMediaType        **ppIVideoMediaType
);

Parameters

pVideoInfoHeader

Pointer to the KS_VIDEOINFOHEADER structure to convert. (This structure is identical to the DirectShow VIDEOINFOHEADER structure.)

cbVideoInfoHeader

Size of the KS_VIDEOINFOHEADER structure in bytes.

dwPixelAspectRatioX

The X dimension of the pixel aspect ratio. The pixel aspect ratio is dwPixelAspectRatioX:dwPixelAspectRatioY.

dwPixelAspectRatioY

The Y dimension of the pixel aspect ratio.

InterlaceMode

Member of the MFVideoInterlaceMode enumeration that specifies how the video is interlaced.

VideoFlags

Bitwise OR of flags from the MFVideoFlags enumeration.

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_VIDEOINFOHEADER 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

Requirements

See also

Media Foundation Functions

Media Types