VIDEOINFOHEADER2 Structure

The VIDEOINFOHEADER2 structure describes the bitmap and color information for a video image, including interlace, copy protection, and pixel aspect ratio information.

Requirements

Include Dvdmedia.h.

Syntax

typedef struct tagVIDEOINFOHEADER2 {
    RECT                rcSource;
    RECT                rcTarget;
    DWORD               dwBitRate;
    DWORD               dwBitErrorRate;
    REFERENCE_TIME      AvgTimePerFrame;
    DWORD               dwInterlaceFlags;
    DWORD               dwCopyProtectFlags;
    DWORD               dwPictAspectRatioX; 
    DWORD               dwPictAspectRatioY; 
    DWORD               dwReserved1;        
    DWORD               dwReserved2;        
    BITMAPINFOHEADER    bmiHeader;
} VIDEOINFOHEADER2;

Members

rcSource

RECT structure that specifies what part of the source stream should be used to fill the destination buffer. Renderers can use this field to ask the decoders to stretch or clip. For more information, see Source and Target Rectangles in Video Renderers

rcTarget

RECT structure that specifies that specifies what part of the destination buffer should be used

dwBitRate

Approximate data rate of the video stream, in bits per second.

dwBitErrorRate

Data error rate of the video stream, in bits per second.

AvgTimePerFrame

The video frame's average display time, in 100-nanosecond units.

dwInterlaceFlags

Bit-wise combination of zero or more of the following flags. See the table at the bottom of this page for more information about these flags.

Set undefined flags to zero, or the connection will be rejected.

dwCopyProtectFlags

Flag set with the AMCOPYPROTECT_RestrictDuplication value to indicate duplication of stream should be restricted. If undefined, specify zero or connection will be rejected.

dwPictAspectRatioX

The X dimension of picture aspect ratio. For example, 16 for a 16-inch � 9-inch display.

dwPictAspectRatioY

The Y dimension of picture aspect ratio. For example, 9 for a 16-inch � 9-inch display.

dwReserved1

Reserved. Must be zero.

dwReserved2

Reserved for future use. Must be zero.

bmiHeader

Microsoft� Win32� BITMAPINFO structure that contains color and dimension information for the video image bitmap.

Remarks

Use the bit mask AMINTERLACE_FieldPatternMask to check the field pattern flags in dwInterlaceFlags:

switch (dwInterlaceFlags & AMINTERLACE_FieldPatternMask)
{
    case AMINTERLACE_FieldPatField1Only:
        // Stream never contains a Field 2.

    case AMINTERLACE_FieldPatField2Only:
        // Stream never contains a Field 1.

    case AMINTERLACE_FieldPatBothRegular:
        // One Field 2 for every Field 1.

    case AMINTERLACE_FieldPatBothIrregular:
        // Random pattern of Field 1 and Field 2.
}

Use the bit mask AMINTERLACE_DisplayModeMask to check the display mode flags in dwInterlaceFlags:

switch (dwInterlaceFlags & AMINTERLACE_DisplayModeMask)
{
    case AMINTERLACE_DisplayModeBobOnly:
        // Bob display mode only.

    case AMINTERLACE_DisplayModeWeaveOnly:
        // Weave display mode only.

    case AMINTERLACE_DisplayModeBobOrWeave:
        // Either bob or weave mode.
}

The following table describes the valid combinations of interlace flags and sample properties, for displaying interlaced fields/frames on the Overlay Mixer filter and Video Mixing Renderer filter (Microsoft� Windows� XP only). Sample properties are specified in the dwTypeSpecificFlags member of each sample's AM_SAMPLE2_PROPERTIES structure.