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.

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

  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