D3DDEVICEDESC

The D3DDEVICEDESC structure contains a description of the current device. This structure is used to query the current device by such methods as IDirect3DDevice2::GetCaps.

typedef struct _D3DDeviceDesc { 
    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; 
    DWORD            dwMinTextureWidth, dwMinTextureHeight;
    DWORD            dwMaxTextureWidth, dwMaxTextureHeight;
    DWORD            dwMinStippleWidth, dwMaxStippleWidth;
    DWORD            dwMinStippleHeight, dwMaxStippleHeight;
} D3DDEVICEDESC, *LPD3DDEVICEDESC; 
 

Members

dwSize

Size, in bytes, of this structure. You can use the D3DDEVICEDESCSIZE constant for this value. This member must be initialized before the structure is used.

dwFlags

Flags identifying the members of this structure that contain valid data.

D3DDD_BCLIPPING
	The bClipping member is valid.
D3DDD_COLORMODEL
	The dcmColorModel member is valid.
D3DDD_DEVCAPS
	The dwDevCaps member is valid.
D3DDD_DEVICERENDERBITDEPTH
	The dwDeviceRenderBitDepth member is valid.
D3DDD_DEVICEZBUFFERBITDEPTH
	The dwDeviceZBufferBitDepth member is valid.
D3DDD_LIGHTINGCAPS
	The dlcLightingCaps member is valid.
D3DDD_LINECAPS
	The dpcLineCaps member is valid.
D3DDD_MAXBUFFERSIZE
	The dwMaxBufferSize member is valid.
D3DDD_MAXVERTEXCOUNT
	The dwMaxVertexCount member is valid.
D3DDD_TRANSFORMCAPS
	The dtcTransformCaps member is valid.
D3DDD_TRICAPS
	The dpcTriCaps member is valid.

dcmColorModel

One of the members of the D3DCOLORMODEL enumerated type, specifying the color model for the device.

dwDevCaps

Flags identifying the capabilities of the device.

D3DDEVCAPS_CANRENDERAFTERFLIP
	Device can queue rendering commands after a page flip. Applications should not change their behavior if this flag is set; this capability simply means that the device is relatively fast. This flag was introduced in DirectX 5.
D3DDEVCAPS_DRAWPRIMTLVERTEX
	Device exports a DrawPrimitive-aware HAL. This flag was introduced in DirectX 5.
D3DDEVCAPS_EXECUTESYSTEMMEMORY
	Device can use execute buffers from system memory.
D3DDEVCAPS_EXECUTEVIDEOMEMORY
	Device can use execute buffer from video memory.
D3DDEVCAPS_FLOATTLVERTEX
	Device accepts floating point for post-transform vertex data.
D3DDEVCAPS_SORTDECREASINGZ
	Device needs data sorted for decreasing depth.
D3DDEVCAPS_SORTEXACT
	Device needs data sorted exactly.
D3DDEVCAPS_SORTINCREASINGZ
	Device needs data sorted for increasing depth.
D3DDEVCAPS_TEXTURENONLOCALVIDMEM
	Device can retrieve textures from nonlocal video (AGP) memory. This flag was introduced in DirectX 5. For more information about AGP memory, see Using Non-local Video Memory Surfaces in the DirectDraw documentation.
D3DDEVCAPS_TEXTURESYSTEMMEMORY
	Device can retrieve textures from system memory.
D3DDEVCAPS_TEXTUREVIDEOMEMORY
	Device can retrieve textures from device memory.
D3DDEVCAPS_TLVERTEXSYSTEMMEMORY
	Device can use buffers from system memory for transformed and lit vertices.
D3DDEVCAPS_TLVERTEXVIDEOMEMORY
	Device can use buffers from video memory for transformed and lit vertices.

dtcTransformCaps

One of the members of the D3DTRANSFORMCAPS structure, specifying the transformation capabilities of the device.

bClipping

TRUE if the device can perform 3-D clipping.

dlcLightingCaps

One of the members of the D3DLIGHTINGCAPS structure, specifying the lighting capabilities of the device.

dpcLineCaps and dpcTriCaps

D3DPRIMCAPS structures defining the device's support for line-drawing and triangle primitives.

dwDeviceRenderBitDepth

Device's rendering bit-depth. This can be one or more of the following DirectDraw bit-depth constants: DDBD_8, DDBD_16, DDBD_24, or DDBD_32.

dwDeviceZBufferBitDepth

Device's z-buffer bit-depth. This can be one of the following DirectDraw bit-depth constants: DDBD_8, DDBD_16, DDBD_24, or DDBD_32.

dwMaxBufferSize

Maximum size of the execute buffer for this device. If this member is 0, the application can use any size.

dwMaxVertexCount

Maximum vertex count for this device.

dwMinTextureWidth, dwMinTextureHeight

Minimum texture width and height for this device. These members were introduced in DirectX 5.

dwMaxTextureWidth, dwMaxTextureHeight

Maximum texture width and height for this device. These members were introduced in DirectX 5.

dwMinStippleWidth, dwMaxStippleWidth

Minimum and maximum width of the stipple pattern for this device. These members were introduced in DirectX 5.

dwMinStippleHeight, dwMaxStippleHeight

Minimum and maximum height of the stipple pattern for this device. These members were introduced in DirectX 5.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in d3dcaps.h.

See Also

D3DCOLORMODEL, D3DFINDDEVICERESULT, D3DLIGHTINGCAPS, D3DPRIMCAPS, D3DTRANSFORMCAPS