L_PaintDCBuffer

L_HDC hDC;

handle to the target device context

pBITMAPHANDLE pBitmap;

pointer to the bitmap handle

L_RECT* pSrc;

pointer to the display source rectangle

L_RECT* pClipSrc;

pointer to the display source clipping rectangle

L_RECT* pDst;

pointer to the display destination rectangle

L_RECT* pClipDst;

pointer to the display destination clipping rectangle

L_UINT32 uROP3;

windows ROP code for display

L_UCHAR * pBuffer;

pointer to the source buffer

L_INT nRow;

first row to paint

L_INT nCount;

number of rows to paint

Parameter

Description

hDC

Handle to a device context, such as a screen, to use as the display surface. The mapping mode of the device context must be MM_TEXT.

pBitmap

Pointer to the bitmap handle that describes the image to paint.

pSrc

Pointer to the Windows RECT structure that specifies the part of the bitmap to use as the display source.

The coordinates in the RECT structure are relative to the bitmap. You can pass NULL to use the default, which matches the bitmap.

pClipSrc

Pointer to the Windows RECT structure that specifies the portion of the display source to paint. Generally, this is used for updating the display when part of the source bitmap has changed.

The coordinates in the RECT structure are relative to the bitmap. You can pass NULL to use the default, which matches the bitmap.

pDst

Pointer to the Windows RECT structure that determines how the source rectangle is scaled and how the image is positioned in the device context.

The coordinates in the RECT structure are relative to the device context. There is no default for this parameter. You must specify the RECT structure.

pClipDst

Pointer to the Windows RECT structure that specifies the portion of the display rectangle to paint. Generally, this is used for updating changes in the display surface, such as when a user moves another window, uncovering a part of the image that had been covered up.

The coordinates in the RECT structure are relative to the device context. You can pass NULL to use the default, which matches the device context. In most cases, however, you should use the rectangle returned by the Windows WM_PAINT message.

uROP3

The Windows ROP code that determines how the destination rectangle is updated. This parameter takes the same codes as the Windows BitBlt function. For ordinary painting, use SRCCOPY.

pBuffer

Pointer to the buffer that contains the image data to paint.

nRow

The first row to paint. The painted portion of any row may be limited by the RECT parameters.

nCount

The number of rows to paint. The painted portion of any row may be limited by the RECT parameters. If the image data in pBuffer is compressed 1-bit data, you can specify the number of lines as a negative value (-nLines), as explained in Speeding Up 1-Bit Documents.

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

LTDIS

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.