BOOL EngCopyBits(
| IN SURFOBJ *psoDst, | |
| OUT SURFOBJ *psoSrc, | |
| IN CLIPOBJ *pco, | |
| IN XLATEOBJ *pxlo, | |
| IN RECTL *prclDst, | |
| IN POINTL *pptlSrc | |
| ); |
EngCopyBits translates between device-managed raster surfaces and GDI standard-format bitmaps.
Standard-format bitmaps are single-plane, packed-pixel format. Each scan line is aligned on a 4-byte boundary. These bitmaps have 1, 4, 8, 16, 24, 32, or 64 bits per pixel.
GDI calls this function from its simulations.
Parameters
psoDst
Points to a SURFOBJ structure that describes the destination surface for the copy operation.
psoSrc
Points to a SURFOBJ structure that describes the source surface for the copy operation.
pco
Points to a CLIPOBJ structure that restricts the area of the destination surface that will be affected. This parameter can be null.
pxlo
Points to a XLATEOBJ structure that defines the translation of color indices between the source and target surfaces.
prclDst
Points to a RECTL structure that defines the area in the coordinate system of the destination surface that will be modified. The rectangle is lower-right exclusive, meaning the lower and right edges of this rectangle are not part of the copy.
pptlSrc
Points to a POINTL structure that defines the upper left corner of the source rectangle.
Return Value
The return value is TRUE if the function is successful.
Comments
EngCopyBits should not be called with an empty destination rectangle, and the two points of the destination rectangle must be well-ordered.
See Also