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

• pDD
  Pointer to the DDRAWI_DIRECTDRAW_GBL structure that represents the DirectDraw object.

• 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

See Also

Concepts

DirectDrawSurface Structures

Other Resources

DDSCAPS
DDCOLORKEY