estructura D3DDEVICEDESC_V1 (d3dhal.h)

Artículo
02/06/2025

D3DDeviceDesc_V1 está obsoleto en DirectX 8.0 y versiones posteriores; vea Comentarios. Esta estructura describe las funcionalidades 3D de un dispositivo.

Sintaxis

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;

Miembros

dwSize

Especifica el tamaño en bytes de esta estructura de D3DDEVICEDESC_V1.

dwFlags

Identifica los miembros de esta estructura que contienen datos válidos. Este miembro puede ser un OR bit a bit de cualquiera de los siguientes valores:

valor	significado
D3DDD_BCLIPPING	El miembro bClipping contiene datos válidos.
D3DDD_COLORMODEL	El miembro dcmColorModel contiene datos válidos.
D3DDD_DEVCAPS	El miembro dwDevCaps contiene datos válidos.
D3DDD_DEVICERENDERBITDEPTH	El dwDeviceRenderBitDepthmember contiene datos válidos.
D3DDD_DEVICEZBUFFERBITDEPTH	El dwDeviceZBufferBitDepthmember contiene datos válidos.
D3DDD_LIGHTINGCAPS	El miembro dlcLightingCaps contiene datos válidos.
D3DDD_LINECAPS	El miembro dpcLineCaps contiene datos válidos.
D3DDD_MAXBUFFERSIZE	El miembro dwMaxBufferSize contiene datos válidos.
D3DDD_MAXVERTEXCOUNT	El miembro dwMaxVertexCount contiene datos válidos.
D3DDD_TRANSFORMCAPS	El miembro dtcTransformCaps contiene datos válidos.
D3DDD_TRICAPS	El miembro dpcTriCaps contiene datos válidos.

dcmColorModel

Especifica el modelo de color del dispositivo.

dwDevCaps

Identifica las funcionalidades del dispositivo. Este miembro puede ser un OR bit a bit de cualquiera de los siguientes valores:

valor	significado
D3DDEVCAPS_CANBLTSYSTONONLOCAL	El dispositivo admite un TexBlt desde la memoria del sistema hasta la memoria de vídeo sublocal.
D3DDEVCAPS_CANRENDERAFTERFLIP	El dispositivo puede poner en cola comandos de representación después de un volteo de página. Los dispositivos deben admitir esta funcionalidad en Windows 2000 y versiones posteriores, lo que significa que el controlador siempre establecería esta marca.
D3DDEVCAPS_DRAWPRIMITIVES2	El dispositivo puede admitir D3dDrawPrimitives2 .
D3DDEVCAPS_DRAWPRIMITIVES2EX	El dispositivo puede admitir extended D3dDrawPrimitives2 ; es decir, un controlador compatible con DX7.
D3DDEVCAPS_DRAWPRIMTLVERTEX	El dispositivo puede dibujar primitivos TLVERTEX. Esta marca está obsoleta, pero el controlador debe establecerla.
D3DDEVCAPS_EXECUTESYSTEMMEMORY	El dispositivo puede usar la ejecución de búferes desde la memoria del sistema. El controlador siempre debe establecer este bit.
D3DDEVCAPS_EXECUTEVIDEOMEMORY	El dispositivo puede usar la ejecución de búferes desde la memoria de visualización. El controlador nunca debe establecer este bit.
D3DDEVCAPS_FLOATTLVERTEX	El dispositivo acepta un punto flotante para los datos de vértices posttransformes. Esta marca está obsoleta, pero el controlador debe establecerla.
D3DDEVCAPS_HWRASTERIZATION	El dispositivo tiene aceleración de hardware para la rasterización.
D3DDEVCAPS_HWTRANSFORMANDLIGHT	El dispositivo puede admitir la transformación y la iluminación en hardware. D3DDEVCAPS_DRAWPRIMITIVES2EX también debe establecerse.
D3DDEVCAPS_SEPARATETEXTUREMEMORIES	El dispositivo está texturando de grupos de memoria independientes. Establecer este bit de funcionalidad indica a DirectX 8.0 y versiones posteriores de las aplicaciones de las que se deshabilitan simultáneamente mediante varias texturas.
D3DDEVCAPS_SORTDECREASINGZ	El dispositivo necesita datos ordenados para reducir la profundidad.
D3DDEVCAPS_SORTEXACT	El dispositivo necesita datos ordenados exactamente.
D3DDEVCAPS_SORTINCREASINGZ	El dispositivo necesita datos ordenados para aumentar la profundidad.
D3DDEVCAPS_TEXTURENONLOCALVIDEOMEMORY	El dispositivo puede texturar desde la memoria de vídeo no local.
D3DDEVCAPS_TLVERTEXSYSTEMMEMORY	El dispositivo puede usar búferes de la memoria del sistema para vértices transformados y iluminados. Esta marca está obsoleta, pero el controlador debe establecerla.
D3DDEVCAPS_TLVERTEXVIDEOMEMORY	El dispositivo puede usar búferes de la memoria de visualización para vértices transformados e iluminados. Esta marca está obsoleta y el controlador no debe establecerla.
D3DDEVCAPS_TEXTURESYSTEMMEMORY	El dispositivo puede recuperar texturas de la memoria del sistema.
D3DDEVCAPS_TEXTUREVIDEOMEMORY	El dispositivo puede recuperar texturas de la memoria del dispositivo.

dtcTransformCaps

Especifica una estructura D3DTRANSFORMCAPS que especifica las funcionalidades de transformación del dispositivo. El controlador debe establecer el dwCaps miembro de esa estructura en cero.

bClipping

Establezca en TRUE por el controlador si el dispositivo puede realizar el recorte 3D.

dlcLightingCaps

Especifica las capacidades de iluminación del dispositivo. Se trata de una estructura D3DLIGHTINGCAPS. El controlador debe establecer el dwCaps, dwLightingModely dwNumLights miembros de esa estructura en cero.

dpcLineCaps

Especifica una estructura D3DPRIMCAPS que define las funcionalidades de dibujo del dispositivo para primitivos de línea.

dpcTriCaps

Especifica una estructura D3DPRIMCAPS que define las capacidades de dibujo del dispositivo para primitivos de triángulos.

dwDeviceRenderBitDepth

Especifica la profundidad de bits de representación del dispositivo. Este miembro puede ser un OR bit a bit de las siguientes constantes de profundidad de bits de DirectDraw: DDBD_8, DDBD_16, DDBD_24 o DDBD_32.

dwDeviceZBufferBitDepth

Especifica la profundidad de bits del búfer z del dispositivo. Este miembro puede ser un OR bit a bit de las siguientes constantes de profundidad de bits de DirectDraw: DDBD_8, DDBD_16, DDBD_24 o DDBD_32.

dwMaxBufferSize

Debe establecerse en cero.

dwMaxVertexCount

DirectX 7 y versiones posteriores

DirectX 6

Observaciones

Esta estructura se ha reemplazado por D3DCAPS8 (consulte la documentación del SDK de DirectX 8.0) para DirectX 8.0 y los tiempos de ejecución posteriores, pero es necesario para la compatibilidad con el entorno de ejecución heredado (DirectX 7.0 y versiones anteriores). Consulte Reporting DirectX 8.0 Style Direct3D Capabilities para obtener más información.

La funcióndrvGetDirectDrawInfo del controladordevuelve esta información en la estructura de D3DHAL_GLOBALDRIVERDATA a la que apunta el lpD3DGlobalDriverData miembro de la estructura DD_HALINFO.

El tiempo de ejecución de Direct3D construye la estructura D3DDEVICEDESC7 de nivel de aplicación (documentada en la documentación del SDK de Microsoft Windows) a partir de la información devuelta en la estructura D3DDEVICEDESC_V1 y las funcionalidades extendidas consultadas a través de la función DdGetDriverInfo del controlador. Aunque algunas de las marcas de dwDevCaps están obsoletas en el nivel de controlador, el controlador debe establecerlas correctamente para que las aplicaciones funcionen correctamente.