estructura DD_GETFORMATDATA (d3dhal.h)

DirectX 8.0 y versiones posteriores solo.

DD_GETFORMATDATA es la estructura de datos a la que apunta el campo lpvData de DD_GETDRIVERINFODATA para DD_GETDRIVERINFO2DATA consultas 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 de DD_GETDRIVERINFO2DATA que contiene los datos 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 .

Comentarios

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 que se notifican los formatos no es significativo.

Al procesar esta solicitud GetDriverInfo2 , el controlador debe leer 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.

DirectX 9.0 y versiones posteriores solo.En la entrada, la versión del runtime de DirectX que usa la aplicación se especifica en el miembro dwSize de la estructura DDPIXELFORMAT en formato. Este miembro dwSize se establece en DD_RUNTIME_VERSION, que es 0x00000900 para DirectX 9.0.

Requisitos

Consulte también

DDPIXELFORMAT

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA