MFVideoFlags enumeration

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            = 0x0001 | 0x0002,
  MFVideoFlag_PAD_TO_None            = 0 * 0x0001,
  MFVideoFlag_PAD_TO_4x3             = 1 * 0x0001,
  MFVideoFlag_PAD_TO_16x9            = 2 * 0x0001,
  MFVideoFlag_SrcContentHintMask     = 0x0004 | 0x0008 | 0x0010,
  MFVideoFlag_SrcContentHintNone     = 0 * 0x0004,
  MFVideoFlag_SrcContentHint16x9     = 1 * 0x0004,
  MFVideoFlag_SrcContentHint235_1    = 2 * 0x0004,
  MFVideoFlag_AnalogProtected        = 0x0020,
  MFVideoFlag_DigitallyProtected     = 0x0040,
  MFVideoFlag_ProgressiveContent     = 0x0080,
  MFVideoFlag_FieldRepeatCountMask   = 0x0100 | 0x0200 | 0x0400,
  MFVideoFlag_FieldRepeatCountShift  = 8,
  MFVideoFlag_ProgressiveSeqReset    = 0x0800,
  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

Analog copy protection should be applied.

MFVideoFlag_DigitallyProtected

Digital copy protection should be applied.

MFVideoFlag_ProgressiveContent

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

Used to extract the field repeat count. This flag is obsolete. See Remarks.

MFVideoFlag_ProgressiveSeqReset

The progressive sequence was disrupted and the sequence is interlaced at the break. This flag is obsolete. See Remarks.

MFVideoFlag_PanScanEnabled

Apply the pan and scan rectangle on the output.

MFVideoFlag_LowerFieldFirst

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

The image is represented bottom-up in memory. This flag should be used only with RGB formats.

MFVideoFlags_DXVASurface

Reserved. Do not use.

MFVideoFlags_RenderTargetSurface

Reserved. Do not use.

MFVideoFlags_ForceQWORD

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.

FlagsMedia 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_BottomUpLinearRepUse 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

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

 

 

Show: