 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. |
Describes the bitmap and color information for a video image.
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. See Source and Target Rectangles in Video Renderers for examples of how this member works.
- rcTarget
- Where the video should be displayed. See Source and Target Rectangles in Video Renderers for examples of how this member works.
- dwBitRate
- Approximate bit data rate.
- dwBitErrorRate
- Bit error rate for this stream.
- AvgTimePerFrame
- Average time per frame, in 100-nanosecond units.
- bmiHeader
- Win32 BITMAPINFOHEADER structure that contains color and dimension information for a device-independent bitmap.
- bmiColors
- 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
- Array of DWORD values 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 bmiHeader structure will almost certainly cause problems. You should use the VIDEOINFOHEADERstructure instead. If for some reason you find it absolutely necessary to use the VIDEOINFOstructure, do not access TrueColorInfo, dwBitMasks, and bmiColors directly; use the TRUECOLOR, COLORS, and BITMASKSmacros to return the pointers to the color information.
The first five data Members are equivalent to a VIDEOINFOHEADER structure. They are expanded in full simply to reduce the amount of dereferencing needed when dealing with a pointer to a VIDEOINFO structure.
Which of the TrueColorInfo, dwBitMasks, and bmiColors fields is valid depends on the contents of the BITMAPINFOHEADER structure.