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.