DDCORECAPS structure (ddrawi.h)

The DDCORECAPS structure specifies the core capabilities of the Microsoft DirectDraw driver and its device, which are exposed to an application through the DirectDraw object.

Syntax

typedef struct _DDCORECAPS {
  DWORD   dwSize;
  DWORD   dwCaps;
  DWORD   dwCaps2;
  DWORD   dwCKeyCaps;
  DWORD   dwFXCaps;
  DWORD   dwFXAlphaCaps;
  DWORD   dwPalCaps;
  DWORD   dwSVCaps;
  DWORD   dwAlphaBltConstBitDepths;
  DWORD   dwAlphaBltPixelBitDepths;
  DWORD   dwAlphaBltSurfaceBitDepths;
  DWORD   dwAlphaOverlayConstBitDepths;
  DWORD   dwAlphaOverlayPixelBitDepths;
  DWORD   dwAlphaOverlaySurfaceBitDepths;
  DWORD   dwZBufferBitDepths;
  DWORD   dwVidMemTotal;
  DWORD   dwVidMemFree;
  DWORD   dwMaxVisibleOverlays;
  DWORD   dwCurrVisibleOverlays;
  DWORD   dwNumFourCCCodes;
  DWORD   dwAlignBoundarySrc;
  DWORD   dwAlignSizeSrc;
  DWORD   dwAlignBoundaryDest;
  DWORD   dwAlignSizeDest;
  DWORD   dwAlignStrideAlign;
  DWORD   dwRops[DD_ROP_SPACE];
  DDSCAPS ddsCaps;
  DWORD   dwMinOverlayStretch;
  DWORD   dwMaxOverlayStretch;
  DWORD   dwMinLiveVideoStretch;
  DWORD   dwMaxLiveVideoStretch;
  DWORD   dwMinHwCodecStretch;
  DWORD   dwMaxHwCodecStretch;
  DWORD   dwReserved1;
  DWORD   dwReserved2;
  DWORD   dwReserved3;
  DWORD   dwSVBCaps;
  DWORD   dwSVBCKeyCaps;
  DWORD   dwSVBFXCaps;
  DWORD   dwSVBRops[DD_ROP_SPACE];
  DWORD   dwVSBCaps;
  DWORD   dwVSBCKeyCaps;
  DWORD   dwVSBFXCaps;
  DWORD   dwVSBRops[DD_ROP_SPACE];
  DWORD   dwSSBCaps;
  DWORD   dwSSBCKeyCaps;
  DWORD   dwSSBFXCaps;
  DWORD   dwSSBRops[DD_ROP_SPACE];
  DWORD   dwMaxVideoPorts;
  DWORD   dwCurrVideoPorts;
  DWORD   dwSVBCaps2;
} DDCORECAPS;

Members

dwSize

Specifies the size in bytes of this DDCORECAPS structure.

dwCaps

Indicates a flag that specifies the driver's capabilities. The driver should set the appropriate DDCAPS_Xxx bit for every capability that it supports.

dwCaps2

Specify more of the driver's capabilities. The driver should set the appropriate DDCAPS2_Xxx bit for every capability that it supports.

dwCKeyCaps

Specify the color key capabilities of surfaces. The driver should set the appropriate DDCKEYCAPS_Xxx bit for every capability that it supports.

dwFXCaps

Specify the driver's stretching and effects capabilities. The driver should set the appropriate DDFXCAPS_Xxx bit for every capability that it supports.

dwFXAlphaCaps

This member and its flags are obsolete and should not be used by the driver.

dwPalCaps

Specify the driver's palette capabilities. The driver should set the appropriate DDPCAPS_Xxx bit for every capability that it supports. The DDPCAPS_Xxx flags are defined in ddraw.h. The DirectDraw runtime currently ignores these capabilities.

dwSVCaps

Specify the driver's stereo vision capabilities. The driver should set the appropriate DDSVCAPS_Xxx bit for every capability that it supports.

dwAlphaBltConstBitDepths

Reserved for system use. The driver should ignore this member.

dwAlphaBltPixelBitDepths

Reserved for system use. The driver should ignore this member.

dwAlphaBltSurfaceBitDepths

Reserved for system use. The driver should ignore this member.

dwAlphaOverlayConstBitDepths

Reserved for system use. The driver should ignore this member.

dwAlphaOverlayPixelBitDepths

Reserved for system use. The driver should ignore this member.

dwAlphaOverlaySurfaceBitDepths

Reserved for system use. The driver should ignore this member.

dwZBufferBitDepths

Indicates a flag that specifies the Z buffer depths supported by the driver. This can be one or more of the following values:

dwVidMemTotal

Specifies the total amount of display memory, in bytes.

dwVidMemFree

Specifies the number of bytes of free display memory. The driver sets this member once during initialization to the same value it returns in the dwVidMemTotal member. DirectDraw updates it every time the application does a memory allocation.

dwMaxVisibleOverlays

Specifies the maximum number of visible overlays.

dwCurrVisibleOverlays

Specifies the current number of visible overlays.

dwNumFourCCCodes

Specifies the number of FOURCC codes that the driver supports.

dwAlignBoundarySrc

Specifies the source rectangle alignment. This member can be optionally set by the driver. If the driver sets this member, then the overlay source rectangle's top left coordinate value must be a multiple of dwAlignBoundarySrc.

dwAlignSizeSrc

Specifies the size of the source rectangle, in bytes. This member can be optionally set by the driver. If the driver sets this member, then the overlay source rectangle's width must be a multiple of dwAlignSizeSrc.

dwAlignBoundaryDest

Specifies the destination rectangle alignment. This member can be optionally set by the driver. If the driver sets this member, then the overlay destination rectangle's top left coordinate value must be a multiple of dwAlignBoundaryDest.

dwAlignSizeDest

Specifies the destination rectangle byte size. This member can be optionally set by the driver. If the driver sets this member, then the overlay destination rectangle's width must be a multiple of dwAlignSizeDest.

dwAlignStrideAlign

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

dwRops[DD_ROP_SPACE]

Specifies an array of DD_ROP_SPACE DWORDs that together can hold flags to indicate the ROPs that the driver supports. The driver should set the bitfield for every corresponding ROP that it supports. See the Microsoft Windows SDK documentation for information about ROPs.

ddsCaps

Specifies a DDSCAPS structure that describes the types of surfaces the driver supports.

dwMinOverlayStretch

Specifies the minimum overlay stretch factor multiplied by 1000. For example, a factor of 1.3 should be stored as 1300. The display driver must set the minimum factor to the actual minimum to which the graphics hardware can shrink the overlay. If the graphics hardware has no minimum limitation, set to 1.

dwMaxOverlayStretch

Specifies the maximum overlay stretch factor multiplied by 1000. For example, a factor of 1.3 should be stored as 1300. The display driver must set the maximum factor to the actual maximum to which the graphics hardware can stretch the overlay. If the graphics hardware has no maximum limitation, set to 32000.

dwMinLiveVideoStretch

Specifies the minimum live video stretch factor multiplied by 1000. For example, a factor of 1.3 should be stored as 1300.

dwMaxLiveVideoStretch

Specifies the maximum live video stretch factor multiplied by 1000. For example, a factor of 1.3 should be stored as 1300.

dwMinHwCodecStretch

Specifies the minimum hardware codec stretch factor multiplied by 1000. For example, a factor of 1.3 should be stored as 1300.

dwMaxHwCodecStretch

Specifies the maximum hardware codec stretch factor multiplied by 1000. For example, a factor of 1.3 should be stored as 1300.

dwReserved1

Reserved for system use. The driver should ignore this member.

dwReserved2

Reserved for system use. The driver should ignore this member.

dwReserved3

Reserved for system use. The driver should ignore this member.

dwSVBCaps

Indicates a set of flags that specify the driver-specific capabilities for system-memory-to-display-memory blits. The driver should bitwise OR the appropriate DDCAPS_Xxx flags (see the dwCaps member) to indicate the types of blit operations it supports when blitting from system memory to display memory.

dwSVBCKeyCaps

Indicates a set of flags that specify driver color-key capabilities for system-memory-to-display-memory blits. The driver should bitwise OR the appropriate DDCKEYCAPS_Xxx flags (see the dwCKeyCaps member) to indicate the types of color key operations it supports when blitting from system memory to display memory.

dwSVBFXCaps

Indicates a set of flags that specify driver FX capabilities for system-memory-to-display-memory blits. The driver should bitwise OR the appropriate DDFXCAPS_Xxx flags (see the dwFXCaps member) to indicate the types of effects it supports when blitting from system memory to display memory.

dwSVBRops[DD_ROP_SPACE]

Specifies an array of DD_ROP_SPACE DWORDs that together can hold flags to indicate the ROPs that the driver supports when performing system-memory-to-display-memory blits. The driver should set the bitfield for every corresponding ROP that it supports. See the Microsoft Windows SDK documentation for information about ROPs.

dwVSBCaps

Indicates a set of flags that specify driver-specific capabilities for display-memory-to-system-memory blits. The driver should bitwise OR the appropriate DDCAPS_Xxx flags (see the dwCaps member) to indicate the types of blit operations it supports when blitting from display memory to system memory.

dwVSBCKeyCaps

Indicates a set of flags that specify driver color-key capabilities for display-memory-to-system-memory blits. The driver should bitwise OR the appropriate DDCKEYCAPS_Xxx flags (see the dwCKeyCaps member) to indicate the types of color key operations it supports when blitting from display memory to system memory.

dwVSBFXCaps

Indicates a set of flags that specify driver FX capabilities for display-memory-to-system-memory blits. The driver should bitwise OR the appropriate DDFXCAPS_Xxx flags (see the dwFXCaps member) to indicate the types of effects it supports when blitting from display memory to system memory.

dwVSBRops[DD_ROP_SPACE]

Specifies an array of DD_ROP_SPACE DWORDs that together can hold flags to indicate the ROPs that the driver supports when performing display-memory-to-system-memory blits. The driver should set the bitfield for every corresponding ROP that it supports. See the Windows SDK documentation for information about ROPs.

dwSSBCaps

Indicates a set of flags that specify driver-specific capabilities for system-memory-to-system-memory blits. The driver should bitwise OR the appropriate DDCAPS_Xxx flags (see the dwCaps member) to indicate the types of blit operations it supports when blitting from system memory to system memory.

dwSSBCKeyCaps

Indicates a set of flags that specify driver color-key capabilities for system-memory-to-system-memory blits. The driver should bitwise OR the appropriate DDCKEYCAPS_Xxx flags (see the dwCKeyCaps member) to indicate the types of color key operations it supports when blitting from system memory to system memory.

dwSSBFXCaps

Indicates a set of flags that specify driver FX capabilities for system-memory-to-system-memory blits. The driver should bitwise OR the appropriate DDFXCAPS_Xxx flags (see the dwFXCaps member) to indicate the types of effects it supports when blitting from system memory to system memory.

dwSSBRops[DD_ROP_SPACE]

Specifies an array of DD_ROP_SPACE DWORDs that together can hold flags to indicate the ROPs that the driver supports when performing system-memory-to-system-memory blits. The driver should set the bitfield for every corresponding ROP that it supports. See the Windows SDK documentation for information about ROPs.

dwMaxVideoPorts

Specifies the maximum number of usable VPE objects.

dwCurrVideoPorts

Specifies the current number of VPE objects used. The driver does not need to fill in this member because it is set by DirectDraw.

dwSVBCaps2

Specifies additional driver-specific capabilities for system-memory-to-display-memory blits. Valid flags are identical to the blit-related flags used with the dwCaps2 member.

Remarks

This section contains the DirectDraw driver structure whose name has the form DDCORECAPS, which is the form used on Windows 98/Me. This structure is identical to that whose name has the form DDNTCORECAPS which is the form used on Windows 2000 and later versions. The include file dx95type.h contains a type define from DDNTCORECAPS to DDCORECAPS.

This structure mirrors the first entries of the DDCAPS structure, but is of a fixed size and does not grow as DDCAPS does.

The driver initializes DDCORECAPS when it is initializing the other members of the DD_HALINFO structure in its DrvGetDirectDrawInfo structure. The DirectDraw runtime might update some members.

DirectDraw requests additional driver capabilities by calling the DdGetDriverInfo function that is also returned in the DD_HALINFO structure.

Requirements