The DDRAWI_DDRAWSURFACE_LCLstructure contains local data for each individual DirectDrawSurfaceobject.

typedef struct _DDRAWI_DDRAWSURFACE_LCL {
LPDDRAWI_DDRAWSURFACE_MORE
lpSurfMore
;
LPDDRAWI_DDRAWSURFACE_GBL
lpGbl
;
ULONG_PTR
hDDSurface
;
LPATTACHLIST
lpAttachList
;
LPATTACHLIST
lpAttachListFrom
;
DWORD
dwLocalRefCnt
;
DWORD
dwProcessId
;
DWORD
dwFlags
;
DDSCAPS
ddsCaps
;
union
{
LPDDRAWI_DDRAWPALETTE_INT
lpDDPalette
;
LPDDRAWI_DDRAWPALETTE_INT
lp16DDPalette
;
};
union
{
LPDDRAWI_DDRAWCLIPPER_LCL
lpDDClipper
;
LPDDRAWI_DDRAWCLIPPER_INT
lp16DDClipper
;
};
DWORD
dwModeCreateIn
;
DWORD
dwBackBufferCount
;
DDCOLORKEY
ddckCKDestBlt
;
DDCOLORKEY
ddckCKSrcBlt
;
DWORD
hDC
;
ULONG_PTR
dwReserved1
;
DDCOLORKEY
ddckCDSrcOverlay
;
DDCOLORKEY
ddckCKDestOverlay
;
LPDDRAWI_DDRAWSURFACE_INT
lpSurfaceOverlaying
;
DBLNODE
dbnOverlayNode
;
RECT
rcOverlaySrc
;
RECT
rcOverlayDest
;
DWORD
dwClrXparent
;
DWORD
dwAlpha
;
LONG
lOverlayX
;
LONG
lOverlayY
;
};
typedef struct _DDRAWI_DDRAWSURFACE_LCL
DDRAWI_DDRAWSURFACE_LCL;

Members

lpSurfMore

Pointer to a DDRAWI_DDRAWSURFACE_MOREstructure that contains additional local data.

lpGbl

Pointer to a DDRAWI_DDRAWSURFACE_GBLstructure that contains the display memory information for this surface.

hDDSurface

Windows NT kernel-mode handle.

lpAttachList

Pointer to an ATTACHLISTstructure that contains the list of surfaces to which this surface attached.

lpAttachListFrom

Pointer to an ATTACHLISTstructure that contains the list of surfaces attached to this surface.

dwLocalRefCnt

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

dwProcessId

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

dwFlags

Surface control flags.

Flag	Usage
DDRAWISURF_ATTACHED	Indicates the surface is attached to another surface.
DDRAWISURF_ATTACHED_FROM	Indicates this surface has other surfaces attached to it.
DDRAWISURF_BACKBUFFER	Indicates the surface was originally a back buffer.
DDRAWISURF_DATAISALIASED	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_DCIBUSY	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_DCILOCK	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_EMPTYSURFACE	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_FRONTBUFFER	Indicates the surface was originally a front buffer.
DDRAWISURF_GETDCNULL	This flag is used by DirectDraw and should not be set by the driver.
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_HASDC	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_HASOVERLAYDATA	Indicates the surface has overlay data.
DDRAWISURF_HASPIXELFORMAT	Indicates the surface has pixel format data.
DDRAWISURF_HELCB	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_HW_CKEYDESTBLT	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_HW_CKEYDESTOVERLAY	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_HW_CKEYSRCBLT	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_HW_CKEYSRCOVERLAY	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_IMPLICITCREATE	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_IMPLICITROOT	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_INMASTERSPRITELIST	This flag is reserved for future use.
DDRAWISURF_INVALID	Indicates the surface has been invalidated by a mode set.
DDRAWISURF_ISFREE	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_LOCKEXCLUDEDCURSOR	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_PARTOFPRIMARYCHAIN	Indicates the surface is part of a primary chain.
DDRAWISURF_SETGAMMA	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_SW_CKEYDESTBLT	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_SW_CKEYDESTOVERLAY	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_SW_CKEYSRCBLT	This flag is used by DirectDraw and should not be set by the driver.
DDRAWISURF_SW_CKEYSRCOVERLAY	This flag is used by DirectDraw and should not be set by the driver.

ddsCaps

Pointer to a DDSCAPSstructure that contains the capabilities of the surface.

lpDDPalette

Pointer to a DDRAWI_DDRAWPALETTE_INTstructure that contains the palette information associated with this surface.

lp16DDPalette

16-bit pointer to a DDRAWI_DDRAWPALETTE_INTstructure that contains the palette information associated with this surface.

lpDDClipper

Pointer to a DDRAWI_DDRAWCLIPPER_LCLstructure that contains the clip list information associated with this surface.

lp16DDClipper

16-bit pointer to a DDRAWI_DDRAWCLIPPER_INTstructure that contains the clip list information associated with this surface.

dwModeCreateIn

This member is used by DirectDraw and should not be set by the driver.

dwBackBufferCount

Indicates the number of back buffers that were created for this surface.

ddckCKDestBlt

Pointer to a DDCOLORKEYstructure that contains the color key information for destination blit use.

ddckCKSrcBlt

Pointer to a DDCOLORKEYstructure that contains the color key information for source blit use.

hDC

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

dwReserved1

Reserved for use by the display driver. In the 1.0 release of DXPAK, this member was used to store the ddgpe surface pointer. The dwReserved1field of the DDRAWI_DDRAWSURFACE_GBLstructure is now used for that purpose.

ddckCDSrcOverlay

Pointer to a DDCOLORKEYstructure that contains the color key information for source overlay use.

ddckCKDestOverlay

Pointer to a DDCOLORKEYstructure that contains the color key information for destination overlay use.

lpSurfaceOverlaying

Pointer to a DDRAWI_DDRAWSURFACE_INTstructure that contains the information about the surface that is being overlayed.

dbnOverlayNode

Pointer to a DBLNODEstructure that contains the pointers to the previous and next structures.

rcOverlaySrc

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

rcOverlayDest

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

dwClrXparent

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

dwAlpha

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

lOverlayX

Indicates the current X overlay position.

lOverlayY

Indicates the current Y overlay position.

Remarks

Every member of the structure after the dwReserved1 member is only allocated if the surface can be used for overlays. When this part of the structure is allocated, ddckCDSrcOverlaymust not be moved from the start of this area.

---

 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.