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)

See also

Media Foundation Structures

Media Types