DDGPE::BltExpanded (Windows Embedded CE 6.0)

1/6/2010

This method sets up and performs a GPE blit with any acceleration you have added to your concrete DDGPE class.

Syntax

virtual SCODE BltExpanded(
  DDGPESurf* pDst,
  DDGPESurf* pSrc, 
  DDGPESurf* pPattern, 
  DDGPESurf* pMask, 
  CLIPOBJ* pco, 
  XLATEOBJ* pxlo, 
  CONST RECT* prclDst, 
  CONST RECT* prclSrc, 
  ULONG solidColor, 
  ULONG bltFlags, 
  ULONG rop4
);
virtual SCODE BltExpanded(
  DDGPESurf* pDst, 
  DDGPESurf* pSrc, 
  DDGPESurf* pPattern, 
  CONST RECT* prclDst, 
  CONST RECT* prclSrc, 
  ULONG solidColor, 
  ULONG bltFlags, 
  ULONG rop4 
);

Parameters

• pDst
  Pointer to the surface that the blit will modify. This is the destination surface.

• pSrc
  Pointer to the surface containing the source data.

• pPattern
  Pointer to the surface object containing a pattern to be used in a PATCOPY blit.

• pMask
  Optional. A pointer to a surface that provides a mask for the source. The mask is defined by a logic map, which is a bitmap with one bit per pixel (bpp). The mask will always be large enough to contain the relevant source; tiling is unnecessary. This parameter can be used by the hardware blit, or if the current blit is not supported by hardware, it will be passed to the standard GPE blit emulation functions. If no mask is desired, set this parameter to NULL.

• pco
  Optional. A pointer to a CLIPOBJ blit that limits the area to be modified in the destination. If the hardware implementation does not support the current blit, this parameter will be passed on to the emulated blit in GPE. If no clipping is required, set this parameter to NULL.

• pxlo
  Optional. A pointer to an XLATEOBJ blit that specifies how to translate color indexes between the source and target surfaces. If this parameter is not required for a particular blit, set it to NULL.

• prclDst
  Pointer to a rectangle in the destination surface that encloses the area to modify.

• prclSrc
  Pointer to the rectangle in the source surface that encloses the bits to use in the blit.

• solidColor
  Color to use in solid-fill blit operations.

• bltFlags
  Flags for the blit.

• rop4
  The raster operation that should be performed.

Return Value

The return value is S_OK, if the function is successful. Otherwise, an error code is returned.

Remarks

Typically, you use this function to execute a GPE blit from your DirectDraw hardware abstraction layer (DDHAL) implementation in your display driver.

Requirements

See Also

Reference

XLATEOBJ

Concepts

DDGPE Class
DDGPE Class Definition