MFVideoInfo structure (mfobjects.h)
Contains video format information that applies to both compressed and uncompressed formats.
This structure is used in the MFVIDEOFORMAT structure.
Syntax
typedef struct _MFVideoInfo {
DWORD dwWidth;
DWORD dwHeight;
MFRatio PixelAspectRatio;
MFVideoChromaSubsampling SourceChromaSubsampling;
MFVideoInterlaceMode InterlaceMode;
MFVideoTransferFunction TransferFunction;
MFVideoPrimaries ColorPrimaries;
MFVideoTransferMatrix TransferMatrix;
MFVideoLighting SourceLighting;
MFRatio FramesPerSecond;
MFNominalRange NominalRange;
MFVideoArea GeometricAperture;
MFVideoArea MinimumDisplayAperture;
MFVideoArea PanScanAperture;
unsigned __int64 VideoFlags;
} MFVideoInfo;
Members
dwWidth
Width of the decoded image, in pixels.
dwHeight
Height of the decoded image, in pixels.
PixelAspectRatio
Pixel aspect ratio, specified as an MFRatio structure.
SourceChromaSubsampling
Chroma sub-sampling of the original image, specified as a member of the MFVideoChromaSubsampling enumeration.
InterlaceMode
Image interlacing, specified as a member of the MFVideoInterlaceMode enumeration.
TransferFunction
R'G'B' gamma curve function, specified as a member of the MFVideoTransferFunction enumeration.
ColorPrimaries
Color primaries of the video source, specified as a member of the MFVideoPrimaries enumeration. This value provides the conversion from R'G'B' to linear RGB.
TransferMatrix
Conversion matrix from Y'Cb'Cr' to R'G'B, specified as a member of the MFVideoTransferMatrix enumeration.
SourceLighting
Intended viewing conditions, specified as a member of the MFVideoLighting enumeration.
FramesPerSecond
Frames per second, specified as an MFRatio structure. If the frame rate is unknown or variable, the numerator and denominator should both be set to zero. It is invalid for only one member of the MFRatio structure to be zero.
NominalRange
Range of valid RGB values, specified as a member of the MFNominalRange enumeration. The value indicates whether color values contain headroom and toeroom.
GeometricAperture
Geometric aperture, specified as an MFVideoArea structure. For more information, see MF_MT_GEOMETRIC_APERTURE.
MinimumDisplayAperture
The display aperture, specified as an MFVideoArea structure. The display aperture is the region of the video image that is intended to be shown. Any data outside of this area is the overscan region. For more information, see MF_MT_MINIMUM_DISPLAY_APERTURE.
PanScanAperture
Pan-scan rectangle, specified as an MFVideoArea structure. The pan-scan rectangle defines a region of the image that is displayed in pan-and-scan mode. It can be used when wide-screen content is shown on a 4 x 3 display. The value is valid only when the VideoFlags member contains the MFVideoFlag_PanScanEnabled flag.
VideoFlags
Bitwise OR of zero or more flags from the MFVideoFlags enumeration.
Remarks
Developers are encouraged to use media type attributes instead of using the MFVideoInfo structure. The following table lists the attributes that correspond to the members of this structure.
| Structure Member | Media Type Attribute |
|---|---|
| dwWidth, dwHeight | MF_MT_FRAME_SIZE |
| PixelAspectRatio | MF_MT_PIXEL_ASPECT_RATIO |
| SourceChromaSubsampling | MF_MT_VIDEO_CHROMA_SITING |
| InterlaceMode | MF_MT_INTERLACE_MODE |
| TransferFunction | MF_MT_TRANSFER_FUNCTION |
| ColorPrimaries | MF_MT_VIDEO_PRIMARIES |
| TransferMatrix | MF_MT_YUV_MATRIX |
| SourceLighting | MF_MT_VIDEO_LIGHTING |
| FramesPerSecond | MF_MT_FRAME_RATE |
| NominalRange | MF_MT_VIDEO_NOMINAL_RANGE |
| GeometricAperture | MF_MT_GEOMETRIC_APERTURE |
| MinimumDisplayAperture | MF_MT_MINIMUM_DISPLAY_APERTURE |
| PanScanAperture | MF_MT_PAN_SCAN_APERTURE |
| VideoFlags | See MFVideoFlags. |
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) |