Edit

Share via

MFVideoPrimaries enumeration (mfobjects.h)

  • Article

Specifies the color primaries of a video source. The color primaries define how to convert colors from RGB color space to CIE XYZ color space.

Syntax

typedef enum _MFVideoPrimaries {
  MFVideoPrimaries_Unknown = 0,
  MFVideoPrimaries_reserved = 1,
  MFVideoPrimaries_BT709 = 2,
  MFVideoPrimaries_BT470_2_SysM = 3,
  MFVideoPrimaries_BT470_2_SysBG = 4,
  MFVideoPrimaries_SMPTE170M = 5,
  MFVideoPrimaries_SMPTE240M = 6,
  MFVideoPrimaries_EBU3213 = 7,
  MFVideoPrimaries_SMPTE_C = 8,
  MFVideoPrimaries_BT2020 = 9,
  MFVideoPrimaries_XYZ = 10,
  MFVideoPrimaries_DCI_P3 = 11,
  MFVideoPrimaries_ACES = 12,
  MFVideoPrimaries_Display_P3 = 13,
  MFVideoPrimaries_Last,
  MFVideoPrimaries_ForceDWORD = 0x7fffffff
} MFVideoPrimaries;

Constants

 
MFVideoPrimaries_Unknown
Value: 0
The color primaries are unknown.
MFVideoPrimaries_reserved
Value: 1
Reserved.
MFVideoPrimaries_BT709
Value: 2
ITU-R BT.709. Also used for sRGB and scRGB.
MFVideoPrimaries_BT470_2_SysM
Value: 3
ITU-R BT.470-4 System M (NTSC).
MFVideoPrimaries_BT470_2_SysBG
Value: 4
ITU-R BT.470-4 System B,G (NTSC).
MFVideoPrimaries_SMPTE170M
Value: 5
SMPTE 170M.
MFVideoPrimaries_SMPTE240M
Value: 6
SMPTE 240M.
MFVideoPrimaries_EBU3213
Value: 7
EBU 3213.
MFVideoPrimaries_SMPTE_C
Value: 8
SMPTE C (SMPTE RP 145).
MFVideoPrimaries_BT2020
Value: 9
ITU-R BT.2020 color primaries.

Note  Requires Windows 8 or later.

 
MFVideoPrimaries_XYZ
Value: 10
CIE 1931 XYZ (see: CIE 1931 color space). Note that this color space is only well-defined for floating point representations.

Note  Requires Windows 8 or later.

 
MFVideoPrimaries_DCI_P3
Value: 11
DCI-P3

Note  Requires Windows 10, version 1703 or later.

 
MFVideoPrimaries_ACES
Value: 12
Academy Color Encoding System

Note  Requires Windows 10, version 1703 or later.
MFVideoPrimaries_Display_P3
Value: 13
SMPTE EG-432-1 (DCI P3 with D65 white point)
MFVideoPrimaries_Last
Reserved.
MFVideoPrimaries_ForceDWORD
Value: 0x7fffffff
Reserved. This member forces the enumeration type to compile as a DWORD value.

Remarks

This enumeration is used with the MF_MT_VIDEO_PRIMARIES attribute.

For more information about these values, see the remarks for the DXVA2_VideoPrimaries enumeration, which is the DirectX Video Acceleration (DXVA) equivalent of this enumeration.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header mfobjects.h (include Mfidl.h)

See also

Extended Color Information

Media Foundation Enumerations

Video Media Types