DrvCopyBits

  • Article

This function translates between device-managed raster surfaces and graphics device interface (GDI) standard format bitmaps.

BOOL DrvCopyBits(
  OUT SURFOBJ* psoDst,
  IN SURFOBJ* psoSrc,
  IN CLIPOBJ* pco,
  IN XLATEOBJ* pxlo,
  IN RECTL* prclDst,
  IN POINTL* pptlSrc 
);

Parameters

  • psoDst
    [out] Pointer to the destination surface for the copy operation.

  • psoSrc
    [in] Pointer to the source surface for the copy operation.

  • pco
    [in] Pointer to a CLIPOBJ structure that defines a clipping region on the destination surface.

  • pxlo
    [in] Pointer to a XLATEOBJ structure that defines the translation of color indices between the source and target surfaces.

  • prclDst
    [in] Pointer to a RECTL structure that defines the area to be modified. This structure uses the coordinate system of the destination surface. The bottom and right edges of this rectangle are not part of the blit; that is, the rectangle is bottom-right exclusive.

    This function never executes with an empty destination rectangle. The two points that define the rectangle are always well ordered.

  • pptlSrc
    [in] Pointer to a POINTL structure that defines the upper-left corner of the source rectangle.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

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 enclosing and device-dependent bitmaps. The device-dependent format is optional; only a few specialized drivers need to support it. You can send these bitmaps to this function because of the SetDIBitsToDevice and SetBitmapBits, and GDI functions.

Kernel-mode GDI calls this function from its simulations.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Winddi.h.
Link Library: Ddi_ati_lib.lib, Ddi_flat_lib.lib, Ddi_gx_lib.lib, Ddi_mq200_lib.lib, Ddi_nop_lib.lib, Ddi_perm3_lib.lib, Ddi_rflat_lib.lib, Ddi_rgx_lib.lib, or Ddi_tvia5_lib.lib.

See Also

Display Drivers | RECTL

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.