MFConvertColorInfoFromDXVA 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 Extended Color Information.]

Sets the extended color information in a MFVIDEOFORMAT structure.

Syntax

HRESULT MFConvertColorInfoFromDXVA(
  [in, out] MFVIDEOFORMAT *pToFormat,
  [in]      DWORD         dwFromDXVA
);

Parameters

[in, out] pToFormat

Pointer to an MFVIDEOFORMAT structure. The function fills in the structure members that correspond to the DXVA color information in the dwFromDXVA parameter. The function does not modify the other structure members.

[in] dwFromDXVA

DWORD that contains extended color information. The bitfields in the DWORD are defined in the DXVA2_ExtendedFormat structure.

Return value

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

Remarks

This function sets the following fields in the MFVIDEOFORMAT structure.

videoInfo.MFNominalRange
videoInfo.MFVideoLighting
videoInfo.MFVideoPrimaries
videoInfo.MFVideoTransferFunction
videoInfo.MFVideoTransferMatrix
videoInfo.SourceChromaSubsampling

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