Compartir a través de


PFND3DDDI_GETQUERYDATA función de devolución de llamada (d3dumddi.h)

La función GetQueryData recupera información sobre una consulta.

Sintaxis

PFND3DDDI_GETQUERYDATA Pfnd3dddiGetquerydata;

HRESULT Pfnd3dddiGetquerydata(
  HANDLE hDevice,
  const D3DDDIARG_GETQUERYDATA *unnamedParam2
)
{...}

Parámetros

hDevice

Identificador del dispositivo de visualización (contexto de gráficos).

unnamedParam2

pData [in, out]

Puntero a una estructura D3DDDIARG_GETQUERYDATA que contiene la información sobre la consulta que se recupera del controlador.

Valor devuelto

GetQueryData devuelve uno de los siguientes valores:

Código devuelto Descripción
S_OK La operación de consulta se completó y el resultado de la consulta está disponible.
S_FALSE GetQueryData devolvió correctamente. Sin embargo, la operación de consulta no se completó, por lo que el resultado de la consulta no está disponible.
E_OUTOFMEMORY GetQueryData no pudo asignar la memoria necesaria para que se complete.

Comentarios

El tiempo de ejecución de Microsoft Direct3D puede llamar a GetQueryData en cualquier momento después de llamar a la función IssueQuery del controlador de pantalla en modo de usuario. El controlador de visualización en modo de usuario debe comprobar el valor de barrera actual con respecto al valor almacenado en la estructura de consulta privada del controlador para determinar si se ha completado el problema de consulta.

Si se completa la consulta, el controlador debe devolver S_OK; de lo contrario, el controlador debe devolver S_FALSE.

Si un controlador admite optimizaciones de varios procesadores en tiempo de ejecución y expone una versión DDI de 0x0000000B o superior, el tiempo de ejecución llamará a GetQueryData de forma reentrante. El controlador devuelve el valor DDI-version en el miembro DriverVersion de la estructura D3D10DDIARG_OPENADAPTER en una llamada a la función OpenAdapter del controlador. Cuando el tiempo de ejecución llama a GetQueryData de forma reentrante, un subproceso se puede ejecutar dentro de GetQueryData mientras que otro subproceso que hace referencia al mismo dispositivo de visualización se ejecuta dentro de otra función de controlador de pantalla en modo de usuario.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino Escritorio
Encabezado d3dumddi.h (incluya D3dumddi.h)

Consulte también

D3DDDIARG_GETQUERYDATA

D3DDDI_DEVICEFUNCS

IssueQuery