estrutura D3DDEVICEDESC_V1 (d3dhal.h)

Artigo
03/08/2023

D3DDeviceDesc_V1 está obsoleto no DirectX 8.0 e versões posteriores; consulte Comentários. Essa estrutura descreve os recursos 3D de um dispositivo.

Sintaxe

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;

Membros

dwSize

Especifica o tamanho em bytes dessa estrutura D3DDEVICEDESC_V1.

dwFlags

Identifica os membros dessa estrutura que contêm dados válidos. Esse membro pode ser um OR bit a bit de qualquer um dos seguintes valores:

Valor	Significado
D3DDD_BCLIPPING	O membro bClipping contém dados válidos.
D3DDD_COLORMODEL	O membro dcmColorModel contém dados válidos.
D3DDD_DEVCAPS	O membro dwDevCaps contém dados válidos.
D3DDD_DEVICERENDERBITDEPTH	O dwDeviceRenderBitDepthmember contém dados válidos.
D3DDD_DEVICEZBUFFERBITDEPTH	O dwDeviceZBufferBitDepthmember contém dados válidos.
D3DDD_LIGHTINGCAPS	O membro dlcLightingCaps contém dados válidos.
D3DDD_LINECAPS	O membro dpcLineCaps contém dados válidos.
D3DDD_MAXBUFFERSIZE	O membro dwMaxBufferSize contém dados válidos.
D3DDD_MAXVERTEXCOUNT	O membro dwMaxVertexCount contém dados válidos.
D3DDD_TRANSFORMCAPS	O membro dtcTransformCaps contém dados válidos.
D3DDD_TRICAPS	O membro dpcTriCaps contém dados válidos.

dcmColorModel

Especifica o modelo de cores do dispositivo.

dwDevCaps

Identifica os recursos do dispositivo. Esse membro pode ser um OR bit a bit de qualquer um dos seguintes valores:

Valor	Significado
D3DDEVCAPS_CANBLTSYSTONONLOCAL	O dispositivo dá suporte a um TexBlt da memória do sistema à memória de vídeo sublocal.
D3DDEVCAPS_CANRENDERAFTERFLIP	O dispositivo pode enfileirar comandos de renderização após uma inversão de página. Os dispositivos devem dar suporte a esse recurso no Windows 2000 e posterior, o que significa que o driver sempre definiria esse sinalizador.
D3DDEVCAPS_DRAWPRIMITIVES2	O dispositivo pode dar suporte a D3dDrawPrimitives2 .
D3DDEVCAPS_DRAWPRIMITIVES2EX	O dispositivo pode dar suporte a D3dDrawPrimitives2 estendido ; Ou seja, um driver compatível com DX7.
D3DDEVCAPS_DRAWPRIMTLVERTEX	O dispositivo pode desenhar primitivos TLVERTEX. Esse sinalizador é obsoleto, mas deve ser definido pelo driver.
D3DDEVCAPS_EXECUTESYSTEMMEMORY	O dispositivo pode usar buffers de execução da memória do sistema. O driver deve sempre definir esse bit.
D3DDEVCAPS_EXECUTEVIDEOMEMORY	O dispositivo pode usar buffers de execução da memória de exibição. O driver nunca deve definir esse bit.
D3DDEVCAPS_FLOATTLVERTEX	O dispositivo aceita ponto flutuante para dados de vértice posttransformes. Esse sinalizador é obsoleto, mas deve ser definido pelo driver.
D3DDEVCAPS_HWRASTERIZATION	O dispositivo tem aceleração de hardware para rasterização.
D3DDEVCAPS_HWTRANSFORMANDLIGHT	O dispositivo pode dar suporte à transformação e à iluminação no hardware. D3DDEVCAPS_DRAWPRIMITIVES2EX também deve ser definido.
D3DDEVCAPS_SEPARATETEXTUREMEMORIES	O dispositivo está sendo texugulado de pools de memória separados. Definir esse bit de funcionalidade indica para o DirectX 8.0 e versões posteriores de aplicativos dos quais eles são desabilitados simultaneamente usando várias texturas.
D3DDEVCAPS_SORTDECREASINGZ	O dispositivo precisa de dados classificados para diminuir a profundidade.
D3DDEVCAPS_SORTEXACT	O dispositivo precisa de dados classificados exatamente.
D3DDEVCAPS_SORTINCREASINGZ	O dispositivo precisa de dados classificados para aumentar a profundidade.
D3DDEVCAPS_TEXTURENONLOCALVIDEOMEMORY	O dispositivo pode ter textura de memória de vídeo não local.
D3DDEVCAPS_TLVERTEXSYSTEMMEMORY	O dispositivo pode usar buffers da memória do sistema para vértices transformados e iluminados. Esse sinalizador é obsoleto, mas deve ser definido pelo driver.
D3DDEVCAPS_TLVERTEXVIDEOMEMORY	O dispositivo pode usar buffers da memória de exibição para vértices transformados e iluminados. Esse sinalizador é obsoleto e não deve ser definido pelo driver.
D3DDEVCAPS_TEXTURESYSTEMMEMORY	O dispositivo pode recuperar texturas da memória do sistema.
D3DDEVCAPS_TEXTUREVIDEOMEMORY	O dispositivo pode recuperar texturas da memória do dispositivo.

dtcTransformCaps

Especifica uma estrutura D3DTRANSFORMCAPS que especifica os recursos de transformação do dispositivo. O driver deve definir o membro dwCaps dessa estrutura como zero.

bClipping

Defina como TRUE pelo driver se o dispositivo puder executar recorte 3D.

dlcLightingCaps

Especifica os recursos de iluminação do dispositivo. Esta é uma estrutura D3DLIGHTINGCAPS . O driver deve definir os membros dwCaps, dwLightingModel e dwNumLights dessa estrutura como zero.

dpcLineCaps

Especifica uma estrutura D3DPRIMCAPS que define os recursos de desenho do dispositivo para primitivos de linha.

dpcTriCaps

Especifica uma estrutura D3DPRIMCAPS que define os recursos de desenho do dispositivo para primitivos triângulos.

dwDeviceRenderBitDepth

Especifica a profundidade de bits de renderização do dispositivo. Esse membro pode ser um OR bit a bit das seguintes constantes de profundidade de bits DirectDraw: DDBD_8, DDBD_16, DDBD_24 ou DDBD_32.

dwDeviceZBufferBitDepth

Especifica a profundidade de bits do buffer z do dispositivo. Esse membro pode ser um OR bit a bit das seguintes constantes de profundidade de bits DirectDraw: DDBD_8, DDBD_16, DDBD_24 ou DDBD_32.

dwMaxBufferSize

Deve ser definido como zero.

dwMaxVertexCount

DirectX 7 e versões posteriores

DirectX 6

Comentários

Essa estrutura foi substituída por D3DCAPS8 (consulte a documentação do SDK do DirectX 8.0) para o DirectX 8.0 e runtimes posteriores, mas é necessária para compatibilidade de runtime herdado (DirectX 7.0 e anterior). Consulte Reporting DirectX 8.0 Style Direct3D Capabilities para obter detalhes.

A função DrvGetDirectDrawInfo do driver retorna essas informações na estrutura D3DHAL_GLOBALDRIVERDATA para a qual o membro lpD3DGlobalDriverData da estrutura DD_HALINFO aponta.

O runtime do Direct3D constrói a estrutura de D3DDEVICEDESC7 no nível do aplicativo (documentada na documentação do SDK do Microsoft Windows) a partir das informações retornadas na estrutura de D3DDEVICEDESC_V1 e dos recursos estendidos consultados por meio da função DdGetDriverInfo do driver. Embora alguns dos sinalizadores dwDevCaps estejam obsoletos no nível do driver, o driver deve defini-los adequadamente para que os aplicativos funcionem corretamente.