DDHAL_BLTDATA (Windows CE 5.0)

  • Article

Send Feedback

This structure contains the information relevant to blitting. This structure passes the information to the DirectDraw hardware abstraction layer (DDHAL) Blt callback function.

typedef struct _DDHAL_BLTDATA {LPDDRAWI_DIRECTDRAW_GBLlpDD;LPDDRAWI_DDRAWSURFACE_LCLlpDDDestSurface;RECTLrDest;LPDDRAWI_DDRAWSURFACE_LCLlpDDSrcSurface;RECTLrSrc;DWORDdwFlags;DWORDdwROPFlags;DDBLTFXbltFX;HRESULTddRVal;LPDDHALSURFCB_BLTBlt;BOOLIsClipped;RECTLrOrigDest;RECTLrOrigSrc;DWORDdwRectCnt;LPRECTprDestRects;} DDHAL_BLTDATA;

Members

  • lpDD**
    Pointer to the DDRAWI_DIRECTDRAW_GBL structure that represents the DirectDraw object.

  • lpDDDestSurface**
    Pointer to the DDRAWI_DDRAWSURFACE_LCL structure that represents the destination surface, which is the one that is being blitted to.

  • rDest**
    Pointer to a RECT structure that defines the upper-left and lower-right points of the rectangle on the destination surface to which data is blitted. The RECT structure specifies the size and position the blit operation should use as a target on the destination surface memory.

  • lpDDSrcSurface**
    Pointer to the DDRAWI_DDRAWSURFACE_LCL structure that represents the DirectDrawSurface that is the data source for the blit operation.

  • rSrc
    Pointer to a RECT structure that defines the upper-left and lower-right points of the rectangle on the source surface from which data is blitted. The RECT structure specifies the size and position the blit operation should use as data from the source surface memory.

  • dwFlags**
    Specify the type of blit to be performed and which fields have valid data to use for the blit operation.

    The following table shows the possible flags.

    Flag Description
    DDBLT_ASYNC Blits asynchronously through the FIFO in the order received. If no room exists in the hardware FIFO, the call fails. Drivers should ignore this flag and schedule blits asynchronously whenever possible.
    DDBLT_COLORFILL Uses the dwFillColor member in the DDBLTFX structure as the RGB color with which to fill the destination rectangle on the destination surface.
    DDBLT_DDFX Uses the dwDDFX member in the DDBLTFX structure to specify the effects to use for the blit.
    DDBLT_DDROPS Uses the dwDDROPS member in the DDBLTFX structure to specify the raster operations that are not part of the Microsoft Win32® API.
    DDBLT_KEYDESTOVERRIDE Use the dckDestColorkey member in the DDBLTFX structure as the color key for the destination surface. If an override is not being set, then dckDestColorkey does not contain the color key. The driver should test the surface itself.
    DDBLT_KEYSRCOVERRIDE Use the dckSrcColorkey member in the DDBLTFX structure as the color key for the source surface. If an override is not being set, then dckDestColorkey does not contain the color key. The driver should test the surface itself.
    DDBLT_ROP Use the dwROP member in the DDBLTFX structure for the raster operation for this blit. These ROPs are the same as the ones defined in the Win32 API.
    DDBLT_ROTATIONANGLE Use the dwRotationAngle member in the DDBLTFX structure as the angle, specified in 1/100th of a degree, to rotate the surface.
    DDBLT_WAIT Do not return immediately with the DDERR_WASSTILLDRAWING message. If the blit is busy, wait until the blit can be set up or another error occurs.

  • dwROPFlags**
    Flags for the different raster operations. In addition to the raster operations defined in the Microsoft Win32® SDK, this member includes three flags that are communicated only between the driver and DirectDraw, and are not set by or passed on to the application.

    The following table shows what the possible flags.

    Flag Description
    ROP_HAS_PATTERN Indicates the raster operation has a pattern.
    ROP_HAS_SOURCE Indicates the raster operation has a source.
    ROP_HAS_SOURCEPATTERN Indicates the raster operation has a source and a pattern.

  • bltFX**
    DDBLTFX structure that contains the optional fields required by complex blit operations. The valid fields are determined by dwFlags

  • ddRVal**
    Passes the DirectDraw return values, such as DD_OK or DDERR_WASSTILLDRAWING.

  • Blt**
    This member is used by DirectDraw and should not be filled in by the driver.

  • IsClipped**
    Indicates whether this is a clipped blit.

  • rOrigDest**
    Pointer to a RECT structure that defines the unclipped destination rectangle. This member is only valid if IsClipped is TRUE.

  • rOrigSrc**
    Pointer to a RECT structure that defines the unclipped source rectangle (only valid if IsClipped).

  • dwRectCnt**
    Count of destination rectangles. This member is only valid if IsClipped is TRUE.

  • prDestRects**
    Array of destination rectangles. This member is only valid if IsClipped is TRUE.

Requirements

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddrawi.h.

See Also

Blt | DDRAWI_DIRECTDRAW_GBL | DDRAWI_DDRAWSURFACE_LCL | DDBLTFX | RECTL | DirectDrawSurface Structures

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.