estructura DD_GETD3DQUERYDATA (d3dhal.h)

Artículo
02/06/2025

DirectX 9.0 y versiones posteriores solo.

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

Sintaxis

typedef struct _DD_GETD3DQUERYDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  union {
    DWORD        dwQueryIndex;
    D3DQUERYTYPE QueryType;
  };
} DD_GETD3DQUERYDATA;

Miembros

gdi2

Especifica una estructura DD_GETDRIVERINFO2DATA que contiene los datos de GetDriverInfo2.

dwQueryIndex

Especifica el índice del tipo de consulta que se va a devolver.

QueryType

Recibe un valor de la enumeración D3DQUERYTYPE que especifica la funcionalidad de consulta real.

Observaciones

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

Al procesar este GetDriverInfo2 solicitar al controlador que lea el valor de la unión como si fuera el miembro dwQueryIndex y asigne ese valor a uno de los tipos de consulta admitidos (probablemente mediante el uso del valor en dwQueryIndex como índice en una matriz de valores D3DQUERYTYPE). A continuación, el controlador debe copiar ese tipo de consulta en la unión como si fuera el miembro QueryType. 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 tipos de consulta notificados por el controlador. El intervalo del índice debe validarse en la compilación del controlador de depuración.

Para obtener más información sobre D3DQUERYTYPE, consulte la documentación del SDK de DirectX.