DDRAWI_DDRAWSURFACE_LCL
The DDRAWI_DDRAWSURFACE_LCL structure contains local data for each individual DirectDrawSurface object.
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_MORE structure that contains additional local data.lpGbl
Pointer to a DDRAWI_DDRAWSURFACE_GBL structure that contains the display memory information for this surface.hDDSurface
Windows NT kernel-mode handle.lpAttachList
Pointer to an ATTACHLIST structure that contains the list of surfaces to which this surface attached.lpAttachListFrom
Pointer to an ATTACHLIST structure 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 DDSCAPS structure that contains the capabilities of the surface.lpDDPalette
Pointer to a DDRAWI_DDRAWPALETTE_INT structure that contains the palette information associated with this surface.lp16DDPalette
16-bit pointer to a DDRAWI_DDRAWPALETTE_INT structure that contains the palette information associated with this surface.lpDDClipper
Pointer to a DDRAWI_DDRAWCLIPPER_LCL structure that contains the clip list information associated with this surface.lp16DDClipper
16-bit pointer to a DDRAWI_DDRAWCLIPPER_INT structure 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 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.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 dwReserved1 field of the DDRAWI_DDRAWSURFACE_GBL structure is now used for that purpose.ddckCDSrcOverlay
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.lpSurfaceOverlaying
Pointer to a DDRAWI_DDRAWSURFACE_INT structure that contains the information about the surface that is being overlayed.dbnOverlayNode
Pointer to a DBLNODE structure 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, ddckCDSrcOverlay must not be moved from the start of this area.
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.