DD_SURFACE_MORE structure (ddrawint.h)

The DD_SURFACE_MORE structure contains additional local data for each individual DirectDrawSurface object.

Syntax

typedef struct _DD_SURFACE_MORE {
  DWORD               dwMipMapCount;
  PDD_VIDEOPORT_LOCAL lpVideoPort;
  DWORD               dwOverlayFlags;
  DDSCAPSEX           ddsCapsEx;
  DWORD               dwSurfaceHandle;
} *PDD_SURFACE_MORE, DD_SURFACE_MORE;

Members

dwMipMapCount

Contains the number of mipmap levels in the chain.

lpVideoPort

Points to a DD_VIDEOPORT_LOCAL structure of the video port extensions (VPE) object currently writing data to this surface.

dwOverlayFlags

Specifies a set of flags that indicate the overlay flags most recently passed to DdUpdateOverlay. This member is a bitwise OR of any of the following values:

Flag Meaning
DDOVER_ADDDIRTYRECT Add a dirty rectangle to an emulated overlaid surface.
DDOVER_ALPHADEST Use the alpha information in the pixel format or the alpha channel surface attached to the destination surface as the alpha channel for the destination overlay.
DDOVER_ALPHADESTCONSTOVERRIDE Use the dwConstAlphaDest member in the DDOVERLAYFX structure (defined in the Microsoft DirectDraw SDK documentation) as the destination alpha channel for this overlay.
DDOVER_ALPHADESTNEG The NEG suffix indicates that the destination surface becomes more transparent as the alpha value increases.
DDOVER_ALPHADESTSURFACEOVERRIDE Use the lpDDSAlphaDest member in the DDOVERLAYFX structure (defined in the DirectDraw SDK documentation) as the alpha channel destination for this overlay.
DDOVER_ALPHAEDGEBLEND Use the dwAlphaEdgeBlend member in the DDOVERLAYFX structure as the alpha channel for the edges of the image that border the color key colors.
DDOVER_ALPHASRC Use the alpha information in the pixel format or the alpha channel surface attached to the source surface as the source alpha channel for this overlay.
DDOVER_ALPHASRCCONSTOVERRIDE Use the dwConstAlphaSrc member in the DDOVERLAYFX structure (defined in the DirectDraw SDK documentation) as the source alpha channel for this overlay.
DDOVER_ALPHASRCNEG The NEG suffix indicates that the source surface becomes more transparent as the alpha value increases.
DDOVER_ALPHASRCSURFACEOVERRIDE Use the lpDDSAlphaSrc member in the DDOVERLAYFX structure as the alpha channel source for this overlay.
DDOVER_AUTOFLIP Autoflip the overlay whenever the VPE object autoflips.
DDOVER_BOB Display each field of VPE object data individually without causing any jittery artifacts.
DDOVER_BOBHARDWARE Bob is performed using hardware rather than software or emulated.
DDOVER_DDFX Use the overlay FX flags to define special overlay FX.
DDOVER_HIDE Turn this overlay off.
DDOVER_INTERLEAVED Indicates that the surface memory is composed of interleaved fields.
DDOVER_KEYDEST Use the color key associated with the destination surface.
DDOVER_KEYDESTOVERRIDE Use the dckDestColorkey member in the DDOVERLAYFX structure (defined in the DirectDraw SDK documentation) as the color key for the destination surface.
DDOVER_KEYSRC Use the color key associated with the source surface.
DDOVER_KEYSRCOVERRIDE Use the dckSrcColorkey member in the DDOVERLAYFX structure as the color key for the source surface.
DDOVER_OVERRIDEBOBWEAVE Bob and weave decisions should not be overridden by other interfaces. If this flag is set, DirectDraw does not allow a kernel-mode driver to use the kernel-mode video transport functionality to switch the hardware between bob and weave mode.
DDOVER_REFRESHALL Redraw the entire surface on an emulated overlayed surface.
DDOVER_REFRESHDIRTYRECTS Redraw all dirty rectangles on an emulated overlayed surface.
DDOVER_SHOW Turn this overlay on.

ddsCapsEx

Specifies a DDSCAPSEX structure that is used to expose extended surface capabilities. A DDSCAPSEX structure is the same as a DDSCAPS2 structure without the dwCaps member.

dwSurfaceHandle

Specifies a cookie for D3dCreateSurfaceEx so that it can associate a texture handle with the surface.

Requirements

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

See also

D3dCreateSurfaceEx

DD_VIDEOPORT_LOCAL

DdUpdateOverlay