DDRAWI_DDRAWSURFACE_LCL (Compact 2013)

  • Article

3/26/2014

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

See Also

Reference

DirectDrawSurface Structures

Other Resources

DDSCAPS
DDCOLORKEY