Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure describes the bitmap and color information for a video image.

Syntax 

typedef struct tagVIDEOINFO {
  RECT 
rcSource,
  RECT 
rcTarget,
  DWORD 
dwBitRate,
  DWORD 
dwBitErrorRate,
  REFERENCE_TIME 
AvgTimePerFrame;
  BITMAPINFOHEADER 
bmiHeader;
  union {
	RGBQUAD 
bmiColors[iPALETTE_COLORS];
	DWORD 
dwBitMasks[iMASK_COLORS];
	TRUECOLORINFO 
TrueColorInfo;
  };
} VIDEOINFO;

Members

rcSource

Portion of the input video to use.

rcTarget

Where the video should be displayed.

dwBitRate

Approximate bit data rate.

dwBitErrorRate

Bit error rate for this stream.

AvgTimePerFrame

Average time per frame, in 100-nanosecond units.

bmiHeader

Win32 BITMAPINFOHEADERstructure that contains color and dimension information for a device-independent bitmap.

bmiColors[iPALETTE_COLORS]

Array of Win32 RGBQUAD that specifies the video's color palette.

Each structure represents a single color, which is a combination of red, green, and blue intensities.

dwBitMasks[iMASK_COLORS]

Array of DWORDvalues that specify true color bitmasks.

TrueColorInfo

TRUECOLORINFOstructure that contains both a color palette and an array of color bitmasks.

Remarks

Never use this structure unless you are sure that you will use it only to store standard RGB formats.

If you store anything other than standard RGB, the variable size of the bmiHeadermember will almost certainly cause problems.

Instead, use the VIDEOINFOHEADERstructure.

If for some reason you find it necessary to use the VIDEOINFOstructure, do not access TrueColorInfo, dwBitMasks, and bmiColorsdirectly; use the TRUECOLOR, COLORS, and BITMASKSmacros to return the pointers to the color information.

The first five data members are equivalent to a VIDEOINFOHEADERstructure. They are expanded in full to reduce the amount of dereferencing needed when dealing with a pointer to a VIDEOINFOstructure.

Which of the TrueColorInfo, dwBitMasks, and bmiColorsmembers is valid depends on the contents of the BITMAPINFOHEADERstructure.

Requirements

Header dshow.h
Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 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