D3DDEVICEDESC7

The D3DDEVICEDESC7 type contains a description of the current device. This type is used to query the current device by such methods as Direct3DDevice7.GetCaps.

Type D3DDeviceDesc7
    dpcLineCaps As D3DPRIMCAPS
    dpcTriCaps As D3DPRIMCAPS
    dvExtentsAdjust As Single
    dvGuardBandBottom As Single
    dvGuardBandLeft As Single
    dvGuardBandRight As Single
    dvGuardBandTop As Single
    dvMaxVertexW As Single
    lDevCaps As CONST_D3DDEVICEDESCCAPS
    lDeviceRenderBitDepth As Long
    lDeviceZBufferBitDepth As Long
    lFVFCaps As CONST_D3DFVFCAPSFLAGS
    lMaxActiveLights As Long
    lMaxAnisotropy As Long
    lMaxTextureAspectRatio As Long
    lMaxTextureHeight As Long
    lMaxTextureRepeat As Long
    lMaxTextureWidth As Long 
    lMinTextureHeight As Long
    lMinTextureWidth As Long
    lStencilCaps As CONST_D3DSTENCILCAPSFLAGS
    lTextureOpCaps As CONST_D3DTEXOPCAPSFLAGS
    lVertexProcessingCaps As CONST_D3DVTXPCAPS
    nMaxSimultaneousTextures As Integer
    nMaxTextureBlendStages As Integer
    nMaxUserClipPlanes As Integer
    nMaxVertexBlendMatrices As Integer
End Type

Members

dpcLineCaps and dpcTriCaps

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

dvExtentsAdjust

Number of pixels to adjust the extents rectangle outward to accommodate antialiasing kernels.

dvGuardBandBottom, dvGuardBandLeft, dvGuardBandTop, and dvGuardBandRight

The screen-space coordinates of the guard-band clipping region. Coordinates inside this rectangle but outside the viewport rectangle will automatically be clipped.

dvMaxVertexW

Maximum W-based depth value that the device supports.

lDevCaps

One of the constants of the CONST_D3DDEVICEDESCCAPS enumeration identifying the capabilities of the device.

lDeviceRenderBitDepth

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

lDeviceZBufferBitDepth

Device's depth-buffer bit-depth. This can be one or more of the following constants from the CONST_DDBITDEPTHFLAGS enumeration: DDBD_8, DDBD_16, DDBD_24, or DDBD_32.

lFVFCaps

Combination of constants of the CONST_D3DFVFCAPSFLAGS that describe the vertex formats supported by this device.

lMaxActiveLights

Maximum number of lights that can be active simultaneously.

lMaxAnisotropy

Maximum valid value for D3DTSS_MAXANISOTROPY texture-stage state.

lMaxTextureAspectRatio

Maximum texture aspect ratio supported by the hardware; this will typically be a power of 2.

lMaxTextureWidth, lMaxTextureHeight

Maximum texture width and height for this device.

lMaxTextureRepeat

Full range of the integer (non-fractional) bits of the post-normalized texture indices. If the D3DPTEXTURECAPS_TEXREPEATNOTSCALEDBYSIZE flag is set, the device defers scaling by the texture size until after the texture address mode is applied. If it isn't set, the device scales the texture indices by the texture size (largest level-of-detail) prior to interpolation.

lMinTextureWidth, lMinTextureHeight

Minimum texture width and height for this device.

lStencilCaps

Constants of the CONST_D3DSTENCILCAPSFLAGS enumeration specifying supported stencil-buffer operations. Stencil operations are assumed to be valid for all three stencil-buffer operation render states (D3DRENDERSTATE_STENCILFAIL, D3DRENDERSTATE_STENCILPASS, and D3DRENDERSTATE_STENCILFAILZFAIL).

lTextureOpCaps

Combination of constants of the CONST_D3DTEXOPCAPSFLAGS enumeration describing the texture operations supported by this device.

lVertexProcessingCaps

Vertex processing capabilities, described as a combination of constants of the CONST_D3DVTXPCAPS enumeration.

nMaxSimultaneousTextures

Maximum number of textures that can be simultaneously bound to the texture blending stages for this device. See remarks.

nMaxTextureBlendStages

Maximum number of texture blending stages supported by this device.

nMaxUserClipPlanes

Maximum number of user-defined clipping planes supported. This member can range from 0 through 31.

User-defined clipping planes are manipulated by using the Direct3DDevice7.GetClipPlane and Direct3DDevice7.SetClipPlane methods.

nMaxVertexBlendMatrices

Maximum number of matrices that this device can apply when performing geometry blending.

Remarks

The nMaxTextureBlendStages and nMaxSimultaneousTextures members might seem very similar at first glance, but they contain different information. The nMaxTextureBlendStages member contains the total number of texture-blending stages supported by the current device, and the nMaxSimultaneousTextures member describes how many of those stages can have textures bound to them by using the Direct3DDevice7.SetTexture method.

See Also

CONST_D3DCOLORMODEL, D3DLIGHTINGCAPS, D3DPRIMCAPS