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) |