VIDEOINFOHEADER2 (Windows Embedded CE 6.0)

1/6/2010

This structure describes the bitmap and color information for a video image, including interlace, copy protection, and picture aspect ratio information.

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.

    The renderers can use this field to ask the decoders to stretch or clip.

    For Windows Embedded CE see Source and Target Rectangles in Video Renderers for examples of how this member works.

  • dwBitRate
    DWORD value that specifies the video stream's approximate data rate.
  • dwBitErrorRate
    DWORD value that specifies the video stream's data error rate.
  • AvgTimePerFrame
    REFERENCE_TIME value that specifies the video frame's average display time, in milliseconds.
  • dwInterlaceFlags
    Flag set by one of the following values.

    Value Description

    AMINTERLACE_IsInterlaced

    Indicates an interlace stream.

    If 0, other interlace bits are irrelevant.

    AMINTERLACE_1FieldPerSample

    Indicates one field per media sample.

    If 0, indicates 2 fields per media sample.

    AMINTERLACE_Field1First

    Indicates Field 1 is first.

    If 0, indicates Field 2 is first.

    Top field in PAL is field 1, top field in NTSC is field 2.

    AMINTERLACE_UNUSED

    Unused.

    AMINTERLACE_FieldPatternMask

    Bits used to indicate field pattern.

    AMINTERLACE_FieldPatField1Only

    Stream never contains a Field 2.

    AMINTERLACE_FieldPatField2Only

    Stream never contains a Field 1.

    AMINTERLACE_FieldPatBothRegular

    There will be a Field 2 for every Field 1.

    AMINTERLACE_FieldPatBothIrregular

    Random pattern of Field 1s and Field 2s.

    AMINTERLACE_DisplayModeMask

    Bits used to indicate display mode.

    AMINTERLACE_DisplayModeBobOnly

    Indicates Bob display mode only.

    AMINTERLACE_DisplayModeWeaveOnly

    Indicates Weave display mode only.

    AMINTERLACE_DisplayModeBobOrWeave

    Indicates either Bob or Weave display mode.

    Set undefined flags to zero or connection should be rejected.

  • dwCopyProtectFlags
    Flag set with the AMCOPYPROTECT_RestrictDuplication value to indicate duplication of stream should be restricted.

    If undefined, specify zero or connection should be rejected.

  • dwPictAspectRatioX
    The X dimension of picture aspect ratio, for example, 16 for 16 × 9 display (inches by inches, not pixels by pixels).
  • dwPictAspectRatioY
    The Y dimension of picture aspect ratio, for example, 9 for 16 × 9 display (inches by inches, not pixels by pixels).
  • dwReserved1
    Reserved for future use.

    Must be zero; reject connection otherwise

  • dwReserved2
    Reserved for future use.

    Must be zero; reject connection otherwise

  • bmiHeader
    Win32 BITMAPINFOHEADER structure that contains color and dimension information for the video image bitmap.

Requirements

Header dshow.h
Windows Embedded CE Windows CE 2.12 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later

See Also

Reference

DirectShow Structures