Edit

Share via

MFVideoFlags enumeration (mfobjects.h)

  • Article

Contains flags that describe a video stream.

These flags are used in the MFVideoInfo structure, which is part of the MFVIDEOFORMAT structure.

Syntax

typedef enum _MFVideoFlags {
  MFVideoFlag_PAD_TO_Mask,
  MFVideoFlag_PAD_TO_None,
  MFVideoFlag_PAD_TO_4x3,
  MFVideoFlag_PAD_TO_16x9,
  MFVideoFlag_SrcContentHintMask,
  MFVideoFlag_SrcContentHintNone,
  MFVideoFlag_SrcContentHint16x9,
  MFVideoFlag_SrcContentHint235_1,
  MFVideoFlag_AnalogProtected = 0x20,
  MFVideoFlag_DigitallyProtected = 0x40,
  MFVideoFlag_ProgressiveContent = 0x80,
  MFVideoFlag_FieldRepeatCountMask,
  MFVideoFlag_FieldRepeatCountShift = 8,
  MFVideoFlag_ProgressiveSeqReset = 0x800,
  MFVideoFlag_PanScanEnabled = 0x20000,
  MFVideoFlag_LowerFieldFirst = 0x40000,
  MFVideoFlag_BottomUpLinearRep = 0x80000,
  MFVideoFlags_DXVASurface = 0x100000,
  MFVideoFlags_RenderTargetSurface = 0x400000,
  MFVideoFlags_ForceQWORD = 0x7fffffff
} MFVideoFlags;

Constants

 
MFVideoFlag_PAD_TO_Mask
Use this value to mask out the next three flags, which describe the effective aspect ratio of the image. This value by itself is not a valid flag.
MFVideoFlag_PAD_TO_None
Do not modify the picture aspect ratio.
MFVideoFlag_PAD_TO_4x3
Display the image in a 4 x 3 area. If this flag is set, the geometrical aperture of the picture should be expanded to a 4 x 3 area by letterboxing or pillarboxing. The geometrical aperture is the portion of the image that is intended to be viewed, without any overscan region.
MFVideoFlag_PAD_TO_16x9
Display the image in a 16 x 9 area. If this flag is set, the geometrical aperture of the picture should be expanded to a 16 x 9 area by letterboxing or pillarboxing.
MFVideoFlag_SrcContentHintMask
Use this value to mask out the next three flags, which describe the source content. This value by itself is not a valid flag.
MFVideoFlag_SrcContentHintNone
There is no additional information about the source content .
MFVideoFlag_SrcContentHint16x9
The source is a 16 x 9 image encoded within a 4 x 3 area.
MFVideoFlag_SrcContentHint235_1
The source is a 2.35:1 image encoded within a 16 x 9 or 4 x 3 area.
MFVideoFlag_AnalogProtected
Value: 0x20
Analog copy protection should be applied.
MFVideoFlag_DigitallyProtected
Value: 0x40
Digital copy protection should be applied.
MFVideoFlag_ProgressiveContent
Value: 0x80
The video source is progressive content encoded as interlaced video, possibly using 3:2 pulldown. This flag is obsolete. See Remarks.
MFVideoFlag_FieldRepeatCountMask
Used to extract the field repeat count. This flag is obsolete. See Remarks.
MFVideoFlag_FieldRepeatCountShift
Value: 8
Used to extract the field repeat count. This flag is obsolete. See Remarks.
MFVideoFlag_ProgressiveSeqReset
Value: 0x800
The progressive sequence was disrupted and the sequence is interlaced at the break. This flag is obsolete. See Remarks.
MFVideoFlag_PanScanEnabled
Value: 0x20000
Apply the pan and scan rectangle on the output.
MFVideoFlag_LowerFieldFirst
Value: 0x40000
The sample contains the lower field. This flag applies only if the interlace mode is single fields (MFVideoInterlace_FieldSingleUpperFirst or MFVideoInterlace_FieldSingleLowerFirst). This flag is obsolete. See Remarks.
MFVideoFlag_BottomUpLinearRep
Value: 0x80000
The image is represented bottom-up in memory. This flag should be used only with RGB formats.
MFVideoFlags_DXVASurface
Value: 0x100000
Reserved. Do not use.
MFVideoFlags_RenderTargetSurface
Value: 0x400000
Reserved. Do not use.
MFVideoFlags_ForceQWORD
Value: 0x7fffffff
Reserved. This member forces the enumeration type to compile as a QWORD value.

Remarks

Developers are encouraged to use media type attributes instead of using the MFVIDEOFORMAT structure. The following table lists the attributes that correspond to the flags defined in this enumeration.

Flags Media Type Attribute
MFVideoFlag_PAD_TO_None

MFVideoFlag_PAD_TO_4x3

MFVideoFlag_PAD_TO_16x9

 MF_MT_PAD_CONTROL_FLAGS
MFVideoFlag_SrcContentHint16x9

MFVideoFlag_SrcContentHint16x9

MFVideoFlag_SrcContentHint235_1

 MF_MT_SOURCE_CONTENT_HINT
MFVideoFlag_AnalogProtected

MFVideoFlag_DigitallyProtected

 MF_MT_DRM_FLAGS
MFVideoFlag_PanScanEnabled MF_MT_PAN_SCAN_ENABLED
MFVideoFlag_BottomUpLinearRep Use the MF_MT_DEFAULT_STRIDE attribute to specify a negative stride.
 

The following flags were defined to describe per-sample interlacing information, but are obsolete:

  • MFVideoFlag_ProgressiveContent
  • MFVideoFlag_FieldRepeatCountMask
  • MFVideoFlag_FieldRepeatCountShift
  • MFVideoFlag_ProgressiveSeqReset
  • MFVideoFlag_LowerFieldFirst
Instead, components should use sample attributes to describe per-sample interlacing information, as described in the topic Video Interlacing.

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

Media Foundation Enumerations

Media Type Attributes

Media Types