Share via


DDRAWI_DDRAWSURFACE_LCL (Windows Embedded CE 6.0)

1/6/2010

This structure contains local data for each individual DirectDrawSurface object.

Syntax

typedef struct _DDRAWI_DDRAWSURFACE_LCL {
  LPDDRAWI_DIRECTDRAW_GBL pDD;
  DWORD ProcessOwner;
  DDSCAPS ddsCaps;
  BitmapBase_t* Bitmap;
  DWORD dwReserved1;
  LPDDRAWI_DDRAWSURFACE_LCL pNext;
  LPDDRAWI_DDRAWSURFACE_LCL pAttached;
  DWORD dwSurfaceHandle;
  DWORD dwFlags;
  RECT LockedRect;
  DC* pDc;
  DDCOLORKEY ddckCKDestBlt;
  DDCOLORKEY ddckCKSrcBlt;
  DDCOLORKEY ddckCKSrcOverlay;
  DDCOLORKEY ddckCKDestOverlay;
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceOverlaying;
  RECT rcOverlaySource;
  DWORD dwOverlayFlags;
  DDOVERLAYFX ddOverlayFX;
  LPDDRAWI_DDRAWCOLORCONTROL_LCL pColorControl;
  LPDDRAWI_DDRAWGAMMACONTROL_LCL pGammaControl;
  LPDDRAWI_DDRAWCLIPPER_GBL pClipper;
  DWORD dwClientData;
} DDRAWI_DDRAWSURFACE_LCL;

Members

  • ProcessOwner
    Used by DirectDraw and should not be filled in by the driver.
  • ddsCaps
    Pointer to a DDSCAPS structure that contains the capabilities of the surface.
  • Bitmap
    Used by DirectDraw and should not be filled in by the driver.
  • dwReserved1
    If using DDGPE, your surface pointer must be stored here to maintain GPE/DirectDraw compatibility. .
  • pNext
    Used by DirectDraw and should not be filled in by the driver.
  • pAttached
    Pointer to a DDRAWI_DDRAWSURFACE_LCL structure that represents the next surface in this surface's flipping chain. .
  • dwSurfaceHandle
    Used by DirectDraw and should not be filled in by the driver.
  • dwFlags
    Surface control flags.

    The following table shows the possible flags.

    Flag Description

    DDRAWISURF_DDCREATED

    Indicates the surface was created by DDraw, not GDI.

    DDRAWISURF_LOCKED

    Indicates the surface is currently locked.

    DDRAWISURF_LOST

    Indicates the surface is currently lost.

    DDRAWISURF_HASCKEYDESTBLT

    Indicates the surface has CKDestBlt.

    DDRAWISURF_HASCKEYDESTOVERLAY

    Indicates the surface has CKDestOverlay.

    DDRAWISURF_HASCKEYSRCBLT

    Indicates the surface has CKSrcBlt.

    DDRAWISURF_HASCKEYSRCOVERLAY

    Indicates the surface has CKSrcOverlay.

    DDRAWISURF_VISIBLEOVERLAY

    Indicates that an overlay surface is visible over the surface.

  • LockedRect
    Indicates the RECT used to lock the surface if it is locked.
  • pDc
    This member is used by DirectDraw and should not be filled in by the driver.
  • ddckCKDestBlt
    Pointer to a DDCOLORKEY structure that contains the color key information for destination blit use.
  • ddckCKSrcBlt
    Pointer to a DDCOLORKEY structure that contains the color key information for source blit use.
  • ddckCKSrcOverlay
    Pointer to a DDCOLORKEY structure that contains the color key information for source overlay use.
  • ddckCKDestOverlay
    Pointer to a DDCOLORKEY structure that contains the color key information for destination overlay use.
  • pSurfaceOverlaying
    Pointer to a DDRAWI_DDRAWSURFACE_LCL structure that contains the information about the surface that is being overlayed.
  • rcOverlaySource
    This member is used by DirectDraw and should not be filled in by the driver.
  • dwOverlayFlags
    Contains the overlay flags most recently passed to UpdateOverlay.
  • ddOverlayFX
    DDOVERLAYFX structure that contains the current overlay FX.
  • pColorControl
    Pointer to a DDRAWI_DDRAWCOLORCONTROL_LCL structure that contains the color control information associated with this surface.
  • pGammaControl
    Pointer to a DDRAWI_DDRAWGAMMACONTROL_LCL structure that contains the gamma control information associated with this surface.
  • pClipper
    Pointer to a DDRAWI_DDRAWCLIPPER_GBL structure that contains the clip list information associated with this surface.
  • dwClientData
    This member is used by DirectDraw and should not be filled in by the driver.

Requirements

Header ddrawi.h
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Concepts

DirectDrawSurface Structures

Other Resources

DDSCAPS
DDCOLORKEY