D3DDEVICEDESC_V1 estructura (d3dhal.h)

Artículo
02/23/2024

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 valores siguientes:

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 miembro dwDeviceRenderBitDepth contiene datos válidos.
D3DDD_DEVICEZBUFFERBITDEPTH	El miembro dwDeviceZBufferBitDepth 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 valores siguientes:

Valor	Significado
D3DDEVCAPS_CANBLTSYSTONONLOCAL	El dispositivo admite un TexBlt desde la memoria del sistema a la memoria de vídeo sublocal.
D3DDEVCAPS_CANRENDERAFTERFLIP	El dispositivo puede poner en cola los 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 debe establecerla el controlador.
D3DDEVCAPS_EXECUTESYSTEMMEMORY	El dispositivo puede usar búferes de ejecución de la memoria del sistema. El controlador siempre debe establecer este bit.
D3DDEVCAPS_EXECUTEVIDEOMEMORY	El dispositivo puede usar búferes de ejecución de 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 debe establecerla el controlador.
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 que se deshabilitan de forma simultánea 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 de 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 debe establecerla el controlador.
D3DDEVCAPS_TLVERTEXVIDEOMEMORY	El dispositivo puede usar búferes de la memoria para vértices transformados y 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 miembro dwCaps de esa estructura en cero.

bClipping

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

dlcLightingCaps

Especifica las funciones de iluminación del dispositivo. Se trata de una estructura D3DLIGHTINGCAPS . El controlador debe establecer los miembros dwCaps, dwLightingModel y dwNumLights de esa estructura en cero.

dpcLineCaps

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

dpcTriCaps

Especifica una estructura de D3DPRIMCAPS que define las funciones 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

Comentarios

Esta estructura se ha reemplazado por D3DCAPS8 (consulte la documentación del SDK de DirectX 8.0) para DirectX 8.0 y los entornos 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 (Funcionalidades de DirectX 8.0 style Direct3D ) para obtener más información.

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

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