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.
| 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
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
See also