DD_SURFACE_LOCAL structure (ddrawint.h)

  • Article

The DD_SURFACE_LOCAL structure contains surface-related data that is unique to an individual surface object.

Syntax

typedef struct _DD_SURFACE_LOCAL {
  PDD_SURFACE_GLOBAL lpGbl;
  DWORD              dwFlags;
  DDSCAPS            ddsCaps;
  ULONG_PTR          dwReserved1;
  union {
    DDCOLORKEY ddckCKSrcOverlay;
    DDCOLORKEY ddckCKSrcBlt;
  };
  union {
    DDCOLORKEY ddckCKDestOverlay;
    DDCOLORKEY ddckCKDestBlt;
  };
  PDD_SURFACE_MORE   lpSurfMore;
  PDD_ATTACHLIST     lpAttachList;
  PDD_ATTACHLIST     lpAttachListFrom;
  RECT               rcOverlaySrc;
} *PDD_SURFACE_LOCAL, DD_SURFACE_LOCAL;

Members

lpGbl

Points to the DD_SURFACE_GLOBAL structure containing surface data that is shared globally with multiple surfaces.

dwFlags

Specifies a set of surface flags. This member is a bitwise OR of any of the following values:

Flag Meaning
DDRAWISURF_BACKBUFFER The surface was originally a back buffer.
DDRAWISURF_DRIVERMANAGED The surface is a driver managed texture used with Microsoft Direct3D.
DDRAWISURF_FRONTBUFFER The surface was originally a front buffer.
DDRAWISURF_HASCKEYSRCBLT The surface has source color key overlay data in the ddckCKSrcBlt member.
DDRAWISURF_HASOVERLAYDATA The surface has overlay data.
DDRAWISURF_HASPIXELFORMAT The surface has pixel format data.
DDRAWISURF_INVALID The surface has been invalidated by a mode setting operation.

ddsCaps

Specifies a DDSCAPS structure that describes the capabilities of the surface.

dwReserved1

Reserved for use by the display driver.

ddckCKSrcOverlay

Specifies a DDCOLORKEY structure (defined in the Microsoft DirectDraw SDK documentation) that contains the color key information for source overlay use.

ddckCKSrcBlt

Specifies a DDCOLORKEY structure that describes the color key for source color key overlays.

ddckCKDestOverlay

Specifies a DDCOLORKEY structure that contains the color key information for destination overlay use.

ddckCKDestBlt

Specifies a DDCOLORKEY structure that describes the color key for destination color key overlays.

lpSurfMore

Points to a DD_SURFACE_MORE structure that contains additional local surface data.

lpAttachList

Points to a DD_ATTACHLIST structure that contains the list of surfaces to which this surface attached.

lpAttachListFrom

Points to a DD_ATTACHLIST structure that contains the list of surfaces attached to this surface.

rcOverlaySrc

Reserved for system use and should be ignored by the driver.

Requirements

Requirement Value
Header ddrawint.h (include Winddi.h)