Compartir a través de


estructura DD_GETFORMATDATA (d3dhal.h)

Solo DirectX 8.0 y versiones posteriores.

DD_GETFORMATDATA es la estructura de datos a la que apunta el campo lpvData de DD_GETDRIVERINFODATA para las consultas de DD_GETDRIVERINFO2DATA con el tipo D3DGDI2_TYPE_GETFORMAT.

Sintaxis

typedef struct _DD_GETFORMATDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwFormatIndex;
  DDPIXELFORMAT         format;
} DD_GETFORMATDATA;

Miembros

gdi2

Especifica una estructura DD_GETDRIVERINFO2DATA que contiene los datos de GetDriverInfo2.

dwFormatIndex

Especifica el índice del formato de píxel que se va a devolver.

format

Recibe el formato de píxel real en una estructura DDPIXELFORMAT.

Observaciones

El tiempo de ejecución identifica el formato que se va a devolver con un índice entero cuyo valor varía entre cero y uno menor que el número de formatos admitidos notificados anteriormente por el controlador. El modo en que estos índices se asignan a formatos reales se deja al controlador. Sin embargo, cada índice debe asignarse de forma única a un formato admitido. El orden en el que se notifican los formatos no es significativo.

Al procesar este GetDriverInfo2 solicitud, el controlador debe leer el dwFormatIndex y asignarlo a uno de los formatos admitidos (probablemente mediante dwFormatIndex como índice en una matriz de estructuras DDPIXELFORMAT) y, a continuación, copie ese formato en el campo de formato del campo DD_GETFORMATDATA. El tiempo de ejecución garantiza que solo pasa un índice al controlador que está en el intervalo cero a uno menor que el número de formatos de superficie notificados por el controlador. El intervalo del índice debe validarse en la compilación del controlador de depuración.

Solo DirectX 9.0 y versiones posteriores.En la entrada, la versión del entorno de ejecución de DirectX que usa la aplicación se especifica en el dwSize miembro de la estructura DDPIXELFORMAT en formato . Este miembro dwSize está establecido en DD_RUNTIME_VERSION, que es 0x00000900 para DirectX 9.0.

Requisitos

Requisito Valor
encabezado de d3dhal.h (incluya D3dhal.h)

Consulte también

DDPIXELFORMAT de

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA