|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.|
This function translates between device-managed raster surfaces and GDI standard format bitmaps.
BOOL DrvCopyBits( OUT SURFOBJ * psoDst , IN SURFOBJ * psoSrc , IN CLIPOBJ * pco , IN XLATEOBJ * pxlo , IN RECTL * prclDst , IN POINTL * pptlSrc );
This function is never called with an empty destination rectangle. The two points that define the rectangle are always well ordered.
TRUE indicates success.
This function is required for a device driver that has device-managed bitmaps or raster surfaces. The implementation in the driver must translate driver surfaces to and from any standard-format bitmap.
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.
This function should ideally be able to deal with run-length encloding and device-dependent bitmaps. The device-dependent format is optional; only a few specialized drivers need to support it. These bitmaps can be sent to this function as a result of the following GDI functions: SetDIBits, SetDIBitsToDevice, GetDIBits, SetBitmapBits, and GetBitmapBits.
Kernel-mode GDI calls this function from its simulations.
|Runs on||Versions||Defined in||Include||Link to|
|Windows CE OS||1.0 and later|
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004