TheDrawDibDrawfunction draws a DIB to the screen.
BOOL DrawDibDraw( HDRAWDIBhdd,HDChdc,intxDst,intyDst,intdxDst,intdyDst,LPBITMAPINFOHEADERlpbi,LPVOIDlpBits,intxSrc,intySrc,intdxSrc,intdySrc,UINTwFlags);Parameters
hdd
Handle to a DrawDib DC.
hdc
Handle to the DC.
xDst
The x-coordinate, in MM_TEXT client coordinates, of the upper left corner of the destination rectangle.
yDst
The y-coordinate, in MM_TEXT client coordinates, of the upper left corner of the destination rectangle.
dxDst
Width, in MM_TEXT client coordinates, of the destination rectangle. IfdxDstis - 1, the width of the bitmap is used.
dyDst
Height, in MM_TEXT client coordinates, of the destination rectangle. IfdyDstis - 1, the height of the bitmap is used.
lpbi
Pointer to theBITMAPINFOHEADERstructure containing the image format. The color table for the DIB withinBITMAPINFOHEADERfollows the format and thebiHeightmember must be a positive value;DrawDibDrawwill not draw inverted DIBs.
lpBits
Pointer to the buffer that contains the bitmap bits.
xSrc
The x-coordinate, in pixels, of the upper left corner of the source rectangle. The coordinates (0,0) represent the upper left corner of the bitmap.
ySrc
The y-coordinate, in pixels, of the upper left corner of the source rectangle. The coordinates (0,0) represent the upper left corner of the bitmap.
dxSrc
Width, in pixels, of the source rectangle.
dySrc
Height, in pixels, of the source rectangle.
wFlags
Applicable flags for drawing. The following values are defined.
Value
DDF_BACKGROUNDPAL
DDF_DONTDRAW
DDF_FULLSCREEN
DDF_HALFTONE
DDF_HURRYUP
DDF_NOTKEYFRAME
DDF_SAME_HDC
DDF_SAME_DRAW
DDF_UPDATE
Return Values
Returns TRUE if successful or FALSE otherwise.
Remarks
DDF_DONTDRAW causesDrawDibDrawto decompress but not display an image. A subsequent call toDrawDibDrawspecifying DDF_UPDATE displays the image.
If the DrawDib DC does not have an off-screen buffer specified, specifying DDF_DONTDRAW causes the frame to be drawn to the screen immediately. Subsequent calls toDrawDibDrawspecifying DDF_UPDATE fail.
Although they are set at different times, DDF_UPDATE and DDF_DONTDRAW can be used together to create composite images off-screen. When the off-screen image is complete, you can display the image by callingDrawDibDraw.
Requirements
Windows NT/2000/XP:Included in Windows NT 3.1 and later.
Windows 95/98/Me:Included in Windows 95 and later.
Header:Declared in Vfw.h.
Library:Use Vfw32.lib.
Used: xiazeju
