DDRAWI_DDRAWSURFACE_MORE (Windows CE 5.0)

Send Feedback

This structure contains additional local data for each individual DirectDrawSurface object.

typedef struct _DDRAWI_DDRAWSURFACE_MORE {DWORDdwSize;IUNKNOWN_LISTFAR* lpIUnknowns;LPDDRAWI_DIRECTDRAW_LCLlpDD_lcl;DWORDdwPageLockCount;DWORDdwBytesAllocated;LPDDRAWI_DIRECTDRAW_INTlpDD_int;DWORDdwMipMapCount;LPDDRAWI_DDRAWCLIPPER_INTlpDDIClipper;LPHEAPALIASINFOlpHeapAliasInfo;DWORDdwOverlayFlags;VOID* rgjunc;LPDDRAWI_DDVIDEOPORT_LCLlpVideoPort;LPDDOVERLAYFXlpddOverlayFX;DDSCAPSEXddsCapsEx;DWORDdwTextureStage;LPVOIDdwDDRAWReserved;LPVOIDdwDDRAWReserved2;LPVOIDlpDDrawReserved3;DWORDdwDDrawReserved4;DWORDdwDDrawReserved5;LPDWORDlpGammaRamp;LPDWORDlpOriginalGammaRamp;LPVOIDlpDDrawReserved6;}DDRAWI_DDRAWSURFACE_MORE;

Members

• dwSize**
  Size of the structure. This member must be initialized before the structure is used.

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

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

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

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

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

• dwMipMapCount**
  Contains the number of mipmap levels in the chain.

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

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

• dwOverlayFlags**
  Contains the overlay flags most recently passed to UpdateOverlay.

  The following table shows the possible flags.

  Flag	Description
  DDOVER_ADDDIRTYRECT	Adds a dirty rectangle to an emulated overlayed surface.
  DDOVER_ALPHADEST	Uses 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	Uses the dwConstAlphaDest field in the DDOVERLAYFX structure as the destination alpha channel for this overlay.
  DDOVER_ALPHADESTNEG	Indicates that the destination surface becomes more transparent as the alpha value increases.
  DDOVER_ALPHADESTSURFACEOVERRIDE	Uses the lpDDSAlphaDest field in the DDOVERLAYFX structure as the alpha channel destination for this overlay.
  DDOVER_ALPHAEDGEBLEND	Uses the dwAlphaEdgeBlend field in the DDOVERLAYFX structure as the alpha channel for the edges of the image that border the color key colors.
  DDOVER_ALPHASRC	Uses 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	Uses the dwConstAlphaSrc field in the DDOVERLAYFX structure as the source alpha channel for this overlay.
  DDOVER_ALPHASRCNEG	Indicates that the source surface becomes more transparent as the alpha value increases.
  DDOVER_ALPHASRCSURFACEOVERRIDE	Uses the lpDDSAlphaSrc field in the DDOVERLAYFX structure as the alpha channel source for this overlay.
  DDOVER_AUTOFLIP	Autoflips the overlay whenever the video port autoflips.
  DDOVER_BOB	Displays each field of video port data individually without causing jittery artifacts.
  DDOVER_BOBHARDWARE	Indicates that hardware, not software or emulation, performs a bob operation.
  DDOVER_DDFX	Uses the overlay FX flags to define special overlay FX.
  DDOVER_HIDE	Turns this overlay off.
  DDOVER_INTERLEAVED	Indicates that the surface memory is composed of interleaved fields.
  DDOVER_KEYDEST	Uses the color key associated with the destination surface.
  DDOVER_KEYDESTOVERRIDE	Uses the dckDestColorkey field in the DDOVERLAYFX structure as the color key for the destination surface.
  DDOVER_KEYSRC	Uses the color key associated with the source surface.
  DDOVER_KEYSRCOVERRIDE	Uses the dckSrcColorkey field in the DDOVERLAYFX structure as the color key for the source surface.
  DDOVER_OVERRIDEBOBWEAVE	Indicates that bob and weave operations should not be overridden by other interfaces.
  DDOVER_REFRESHALL	Redraws the entire surface on an emulated overlayed surface.
  DDOVER_REFRESHDIRTYRECTS	Redraws all dirty rectangles on an emulated overlayed surface.
  DDOVER_SHOW	Turns this overlay on.

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

• lpVideoPort**
  Pointer to a DDRAWI_DDVIDEOPORT_LCL structure of the video port currently writing data to this surface.

• lpddOverlayFX**
  Pointer to a DDOVERLAYFX structure that contains the current overlay FX.

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

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

• dwDDRAWReserved
  Reserved for future use.

• dwDDRAWReserved2
  Reserved for future use.

• lpDDrawReserved3
  Reserved for future use.

• dwDDrawReserved4
  Reserved for future use.

• dwDDrawReserved5
  Reserved for future use.

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

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

• lpDDrawReserved6
  Reserved for future use.

Requirements

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddrawi.h.

See Also

DDOVERLAYFX | DDRAWI_DDVIDEOPORT_LCL | DirectDrawSurface Structures

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.