 Important: |
|---|
| 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. |
The BltExpandedfunction sets up and performs a GPEblit, with any acceleration you have added to your concrete DDGPEclass.
You would normally use this function to execute a GPEblit from your DirectDraw HAL implementation in your display driver.
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
- A pointer to the surface that will be modified by the blit. This is the destination surface.
- pSrc
- A pointer to the surface containing the source data.
- pPattern
- A pointer to the surface object containing a pattern to be used in a PATCOPY blit.
- pMask
- This optional parameter points 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. 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 GPEblit emulation functions. If no mask is desired, this parameter should be set to NULL.
- pco
- This optional parameter points to a CLIPOBJ 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, this parameter should be set to NULL.
- pxlo
- This optional parameter points to an XLATEOBJ that specifies how color indexes are to be translated between the source and target surfaces. If this parameter is not required for a particular blit, it should be set to NULL.
- prclDst
- A pointer to a rectangle in the destination surface that encloses the area that should be modified.
- prclSrc
- A pointer to the rectangle in the source surface that encloses the bits that will be used in the blit.
- solidColor
- The color to use in solid fill blit operations.
- bltFlags
- Flags for the blit.
- rop4
- Identifes the raster operation that should be performed.
Return Values
The return value is S_OK if the function is successful. Otherwise an error code is returned.
Last updated on Tuesday, July 13, 2004