DDCAPS

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure represents the capabilities of the hardware exposed through the DirectDraw object.

This structure contains a DDSCAPS structure used in this context to describe what kinds of DirectDrawSurface objects can be created. It may not be possible to simultaneously create all surfaces described by these capabilities.

This structure is used with the IDirectDraw::GetCaps method.

Syntax

typedef struct _DDCAPS { 
  DWORD dwSize;
  DWORD dwCKeyCaps;
  DWORD dwPalCaps;
  DWORD dwBltCaps;
  DWORD dwAlphaCaps;
  DWORD dwOverlayCaps;
  DWORD dwVidMemTotal;
  DWORD dwVidMemFree;
  DWORD dwVidMemStride;
  DWORD dwMaxVisibleOverlays;
  DWORD dwCurrVisibleOverlays;
  DWORD dwNumFourCCCodes;
  DWORD dwAlignBoundarySrc;
  DWORD dwAlignSizeSrc;
  DWORD dwAlignBoundaryDest;
  DWORD dwAlignSizeDest;
  DWORD dwRops[DD_ROP_SPACE];
  DWORD dwMinOverlayStretch;
  DWORD dwMaxOverlayStretch;
  DWORD dwMiscCaps;
} DDCAPS,FAR *LPDDCAPS;  

Members

• dwSize
  Size of the structure, in bytes. This member must be initialized before the structure is used.

• dwCKeyCaps
  Color-key capabilities. The following table shows the possible flags.

  Flag	Description
  DDCKEYCAPS_BOTHBLT	Supports transparent blitting with for both source and destination surfaces.
  DDCKEYCAPS_DESTBLT	Supports transparent blitting with a color key that identifies the replaceable bits of the destination surface for RGB colors.
  DDCKEYCAPS_DESTBLTCLRSPACE	Supports transparent blitting with a color space that identifies the replaceable bits of the destination surface for RGB colors.
  DDCKEYCAPS_DESTBLTCLRSPACEYUV	Supports transparent blitting with a color space that identifies the replaceable bits of the destination surface for YUV colors.
  DDCKEYCAPS_SRCBLT	Supports transparent blitting using the color key for the source with this surface for RGB colors.
  DDCKEYCAPS_SRCBLTCLRSPACE	Supports transparent blitting using a color space for the source with this surface for RGB colors.
  DDCKEYCAPS_SRCBLTCLRSPACEYUV	Supports transparent blitting using a color space for the source with this surface for YUV colors.

• dwPalCaps
  Palette capabilities.

  The following table shows the possible flags.

  Flag	Description
  DDPCAPS_ALPHA	Supports palettes that include an alpha component. For alpha-capable palettes, the peFlags member of for each PALETTEENTRY structure the palette contains is to be interpreted as a single 8-bit alpha value (in addition to the color data in the peRed, peGreen, and peBlue members). A palette created with this flag can only be attached to a texture surface.
  DDPCAPS_PRIMARYSURFACE	Indicates that the palette is attached to the primary surface. Changing the palette has an immediate effect on the display unless the DDPCAPS_VSYNC capability is specified and supported.

• dwBltCaps
  Driver specific blitting capabilities.

  The following table shows the possible flags.

  Flag	Description
  DDBLTCAPS_READSYSMEM	Supports blitting from system memory.
  DDBLTCAPS_WRITESYSMEM	Supports blitting to system memory.
  DDBLTCAPS_FOURCCTORGB	Supports blitting from a surface with a FOURCC pixel format to a surface with an RGB pixel format.
  DDBLTCAPS_COPYFOURCC	Supports blitting from a surface with a FOURCC pixel format to another surface with the same pixel format, or to the same surface.
  DDBLTCAPS_FILLFOURCC	Supports color-fill blitting to a surface with a FOURCC pixel format.

• dwAlphaCaps
  Alpha blitting capabilities.

  The following table shows the possible flags.

  Flag	Description
  DDALPHACAPS_ALPHAPIXELS	Supports per-pixel alpha values specified alongside with the RGB values in the pixel structure.
  DDALPHACAPS_ALPHASURFACE	Unsupported.
  DDALPHACAPS_ALPHAPALETTE	Unsupported.
  DDALPHACAPS_ALPHACONSTANT	Unsupported.
  DDALPHACAPS_ARGBSCALE	Unsupported.
  DDALPHACAPS_SATURATE	Unsupported.
  DDALPHACAPS_PREMULT	Supports pixel formats with premultiplied alpha values.
  DDALPHACAPS_NONPREMULT	Supports pixel formats with non-premultiplied alpha values.
  DDALPHACAPS_ALPHAFILL	Supports color-fill blitting using an alpha value.
  DDALPHACAPS_ALPHANEG	Supports inverted-alpha pixel formats, where 0 indicates fully opaque and 255 indicates fully transparent.

• dwOverlayCaps
  General overlay capabilities.

  The following table shows the possible flags.

  Flag	Description
  DDOVERLAYCAPS_FLIP	Supports surface flipping with overlays.
  DDOVERLAYCAPS_FOURCC	Supports FOURCC pixel formats with overlays. Use IDirectDraw::GetFourCCCodes to determine which FOURCC formats are supported.
  DDOVERLAYCAPS_ZORDER	Supports changing Z order of overlays.
  DDOVERLAYCAPS_MIRRORLEFTRIGHT	Supports surface mirroring in the left-to-right direction for overlays.
  DDOVERLAYCAPS_MIRRORUPDOWN	Supports surface mirroring in the up-to-down direction for overlays.
  DDOVERLAYCAPS_CKEYSRC	Supports source color keying for overlays.
  DDOVERLAYCAPS_CKEYSRCCLRSPACE	Supports source color-space keying for overlays.
  DDOVERLAYCAPS_CKEYSRCCLRSPACEYUV	Supports source color-space keying for overlays with FOURCC pixel formats.
  DDOVERLAYCAPS_CKEYDEST	Supports destination color keying for overlays.
  DDOVERLAYCAPS_CKEYDESTCLRSPACE	Supports destination colo-space keying for overlays.
  DDOVERLAYCAPS_CKEYDESTCLRSPACEYUV	Supports destination color-space keying for overlays with FOURCC pixel formats.
  DDOVERLAYCAPS_CKEYBOTH	Supports simultaneous source and destination color keying for overlays.
  DDOVERLAYCAPS_ALPHADEST	Supports destination alpha blending for overlays.
  DDOVERLAYCAPS_ALPHASRC	Supports source alpha blending for overlays.
  DDOVERLAYCAPS_ALPHADESTNEG	Supports inverted destination alpha blending for overlays.
  DDOVERLAYCAPS_ALPHASRCNEG	Supports inverted source alpha blending for overlays.
  DDOVERLAYCAPS_ALPHACONSTANT	Supports constant alpha blending for overlays (specified in the DDOVERLAYFX structure).
  DDOVERLAYCAPS_ALPHAPREMULT	Supports premultiplied alpha pixel formats for overlay alpha blending.
  DDOVERLAYCAPS_ALPHANONPREMULT	Supports non-premultiplied alpha pixel formats for overlay alpha blending.
  DDOVERLAYCAPS_ALPHAANDKEYDEST	Supports simultaneous source alpha blending with a destination color key for overlays.
  DDOVERLAYCAPS_OVERLAYSUPPORT	Supports overlay surfaces.

• dwVidMemTotal
  Total amount of display memory on the device, in bytes, minus the memory reserved for the primary surface and any private data structures reserved by the driver.

  (This value is the same as the total video memory reported by the IDirectDraw::GetAvailableVidMem method.)

• dwVidMemFree
  Free display memory.

  This value equals the value in dwVidMemTotal, minus any memory currently allocated by the application for surfaces.

  Unlike the GetAvailableVidMem method, which reports the memory available for a particular type of surface, such as a texture, this value reflects the memory available for any type of surface.

• dwVidMemStride
  Video memory stride. This value is 0 if the stride is linear.

• dwMaxVisibleOverlays
  Maximum number of visible overlays or overlay sprites.

• dwCurrVisibleOverlays
  Current number of visible overlays or overlay sprites.

• dwNumFourCCCodes
  Number of FourCC codes.

• dwAlignBoundarySrc
  Source rectangle alignment, in pixels, for an overlay surface.

• dwAlignSizeSrc
  Source rectangle size alignment, in pixels, for an overlay surface.

  Overlay source rectangles must have a pixel width that is a multiple of this value.

• dwAlignBoundaryDest
  Destination rectangle alignment, in pixels, for an overlay surface.

• dwAlignSizeDest
  Destination rectangle size alignment, in pixels, for an overlay surface.

  Overlay destination rectangles must have a pixel width that is a multiple of this value.

• dwRops[DD_ROP_SPACE]
  Raster operations supported.

• dwMinOverlayStretchand dwMaxOverlayStretch
  Minimum and maximum overlay stretch factors multiplied by 1000.

  For example, 1.3 x 1000 = 1300.

• dwMiscCaps
  Miscellaneous video capabilities.

  The following table shows the possible flags.

  Flag	Description
  DDMISCCAPS_READSCANLINE	Supports reading the current scanline being drawn.
  DDMISCCAPS_READMONITORFREQ	Unsupported.
  DDMISCCAPS_READVBLANKSTATUS	Supports reading the current V-Blank status of the hardware.
  DDMISCCAPS_FLIPINTERVAL	Supports interval flipping.
  DDMISCCAPS_FLIPODDEVEN	Supports Even/Odd flipping.
  DDMISCCAPS_FLIPVSYNCWITHVBI	Supports V-Sync-coordinated flipping.
  DDMISCCAPS_COLORCONTROLOVERLAY	Supports color controls on overlay surfaces.
  DDMISCCAPS_COLORCONTROLPRIMARY	Supports color controls on primary surfaces.
  DDMISCCAPS_GAMMACONTROLOVERLAY	Supports gamma controls on overlay surfaces.
  DDMISCCAPS_GAMMACONTROLPRIMARY	Supports gamma controls on primary surfaces.

Requirements