D3DDEVICEDESC_V1 structure

Obsolete in DirectX 8.0 and later versions; see Remarks.

The D3DDEVICEDESC_V1 structure describes the 3D capabilities of a device.

Syntax

typedef struct _D3DDeviceDesc_V1 {
  DWORD            dwSize;
  DWORD            dwFlags;
  D3DCOLORMODEL    dcmColorModel;
  DWORD            dwDevCaps;
  D3DTRANSFORMCAPS dtcTransformCaps;
  BOOL             bClipping;
  D3DLIGHTINGCAPS  dlcLightingCaps;
  D3DPRIMCAPS      dpcLineCaps;
  D3DPRIMCAPS      dpcTriCaps;
  DWORD            dwDeviceRenderBitDepth;
  DWORD            dwDeviceZBufferBitDepth;
  DWORD            dwMaxBufferSize;
  DWORD            dwMaxVertexCount;
} D3DDEVICEDESC_V1, *LPD3DDEVICEDESC_V1;

Members

dwSize

Specifies the size in bytes of this D3DDEVICEDESC_V1 structure.

dwFlags

Identifies the members of this structure that contain valid data. This member can be a bitwise OR of any of the following values:

Value Meaning
D3DDD_BCLIPPING The bClipping member contains valid data.
D3DDD_COLORMODEL The dcmColorModel member contains valid data.
D3DDD_DEVCAPS The dwDevCaps member contains valid data.
D3DDD_DEVICERENDERBITDEPTH The dwDeviceRenderBitDepthmember contains valid data.
D3DDD_DEVICEZBUFFERBITDEPTH The dwDeviceZBufferBitDepthmember contains valid data.
D3DDD_LIGHTINGCAPS The dlcLightingCaps member contains valid data.
D3DDD_LINECAPS The dpcLineCaps member contains valid data.
D3DDD_MAXBUFFERSIZE The dwMaxBufferSize member contains valid data.
D3DDD_MAXVERTEXCOUNT The dwMaxVertexCount member contains valid data.
D3DDD_TRANSFORMCAPS The dtcTransformCaps member contains valid data.
D3DDD_TRICAPS The dpcTriCaps member contains valid data.

dcmColorModel

Specifies the device's color model.

dwDevCaps

Identifies the capabilities of the device. This member can be a bitwise OR of any of the following values:

Value Meaning
D3DDEVCAPS_CANBLTSYSTONONLOCAL The device supports a TexBlt from system memory to sublocal video memory.
D3DDEVCAPS_CANRENDERAFTERFLIP The device can queue rendering commands after a page flip. Devices must support this capability on Windows 2000 and later, meaning that the driver would always set this flag.
D3DDEVCAPS_DRAWPRIMITIVES2 The device can support D3dDrawPrimitives2 .
D3DDEVCAPS_DRAWPRIMITIVES2EX The device can support Extended D3dDrawPrimitives2 ; i.e. a DX7-compliant driver.
D3DDEVCAPS_DRAWPRIMTLVERTEX The device can draw TLVERTEX primitives. This flag is obsolete but must be set by the driver.
D3DDEVCAPS_EXECUTESYSTEMMEMORY The device can use execute buffers from system memory. The driver must always set this bit.
D3DDEVCAPS_EXECUTEVIDEOMEMORY The device can use execute buffers from display memory. The driver must never set this bit.
D3DDEVCAPS_FLOATTLVERTEX The device accepts floating-point for posttransform vertex data. This flag is obsolete but must be set by the driver.
D3DDEVCAPS_HWRASTERIZATION The device has hardware acceleration for rasterization.
D3DDEVCAPS_HWTRANSFORMANDLIGHT The device can support transformation and lighting in hardware. D3DDEVCAPS_DRAWPRIMITIVES2EX must also be set.
D3DDEVCAPS_SEPARATETEXTUREMEMORIES The device is texturing from separate memory pools. Setting this capability bit indicates to DirectX 8.0 and later versions of applications that they are disabled from simultaneously using multiple textures.
D3DDEVCAPS_SORTDECREASINGZ The device needs data sorted for decreasing depth.
D3DDEVCAPS_SORTEXACT The device needs data sorted exactly.
D3DDEVCAPS_SORTINCREASINGZ The device needs data sorted for increasing depth.
D3DDEVCAPS_TEXTURENONLOCALVIDEOMEMORY The device can texture from nonlocal video memory.
D3DDEVCAPS_TLVERTEXSYSTEMMEMORY The device can use buffers from system memory for transformed and lit vertices. This flag is obsolete but must be set by the driver.
D3DDEVCAPS_TLVERTEXVIDEOMEMORY The device can use buffers from display memory for transformed and lit vertices. This flag is obsolete and must not be set by the driver.
D3DDEVCAPS_TEXTURESYSTEMMEMORY The device can retrieve textures from system memory.
D3DDEVCAPS_TEXTUREVIDEOMEMORY The device can retrieve textures from device memory.

dtcTransformCaps

Specifies a D3DTRANSFORMCAPS structure that specifies the transformation capabilities of the device. The driver must set the dwCaps member of that structure to zero.

bClipping

Set to TRUE by the driver if the device can perform 3D clipping.

dlcLightingCaps

Specifies the lighting capabilities of the device. This is a D3DLIGHTINGCAPS structure. The driver must set the dwCaps, dwLightingModel, and dwNumLights members of that structure to zero.

dpcLineCaps

Specifies a D3DPRIMCAPS structure that defines the drawing capabilities of the device for line primitives.

dpcTriCaps

Specifies a D3DPRIMCAPS structure that defines the drawing capabilities of the device for triangle primitives.

dwDeviceRenderBitDepth

Specifies the device's rendering bit-depth. This member can be a bitwise OR of the following DirectDraw bit-depth constants: DDBD_8, DDBD_16, DDBD_24, or DDBD_32.

dwDeviceZBufferBitDepth

Specifies the device's z-buffer bit-depth. This member can be a bitwise OR of the following DirectDraw bit-depth constants: DDBD_8, DDBD_16, DDBD_24, or DDBD_32.

dwMaxBufferSize

Must be set to zero.

dwMaxVertexCount

DirectX 7 and later versions

DirectX 6

Remarks

This structure has been replaced by D3DCAPS8 (see the DirectX 8.0 SDK documentation) for DirectX 8.0 and later runtimes, but is required for legacy runtime (DirectX 7.0 and earlier) compatibility. See Reporting DirectX 8.0 Style Direct3D Capabilities for details.

The driver's DrvGetDirectDrawInfo function returns this information in the D3DHAL_GLOBALDRIVERDATA structure that the lpD3DGlobalDriverData member of the DD_HALINFO structure points to.

The Direct3D runtime constructs the application-level D3DDEVICEDESC7 structure (documented in the Microsoft Windows SDK documentation) from the information returned in the D3DDEVICEDESC_V1 structure and the extended capabilities queried through the driver's DdGetDriverInfo function. While some of the dwDevCaps flags are obsolete at the driver level, the driver must set them appropriately in order for applications to work correctly.

Requirements

   
Header d3dhal.h (include D3dhal.h)

See Also

D3DHAL_GLOBALDRIVERDATA

D3DLIGHTINGCAPS

D3DPRIMCAPS

D3dDrawPrimitives2

DD_HALINFO

DdGetDriverInfo

DrvGetDirectDrawInfo