MFInitMediaTypeFromVideoInfoHeader2 function (mfapi.h)

Initializes a media type from a DirectShow VIDEOINFOHEADER2 structure.

Syntax

HRESULT MFInitMediaTypeFromVideoInfoHeader2(
  IMFMediaType           *pMFType,
  const VIDEOINFOHEADER2 *pVIH2,
  UINT32                 cbBufSize,
  const GUID             *pSubtype
);

Parameters

pMFType

Pointer to the IMFMediaType interface of the media type to initialize. To create the uninitialized media type object, call MFCreateMediaType.

pVIH2

Pointer to a VIDEOINFOHEADER2 structure that describes the media type. The caller must fill in the structure members before calling this function.

cbBufSize

Size of the VIDEOINFOHEADER2 structure, in bytes.

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 VIDEOINFOHEADER2 structure.

Return value

The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The function succeeded.

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 Mfplat.lib
DLL Mfplat.dll

See also

Media Foundation Functions

Media Type Conversions

Media Types