PFND3DDDI_CREATEQUERY función de devolución de llamada (d3dumddi.h)
La función CreateQuery crea recursos del lado controlador para una consulta que el entorno de ejecución de Microsoft Direct3D emite posteriormente para su procesamiento.
Sintaxis
PFND3DDDI_CREATEQUERY Pfnd3dddiCreatequery;
HRESULT Pfnd3dddiCreatequery(
HANDLE hDevice,
D3DDDIARG_CREATEQUERY *unnamedParam2
)
{...}
Parámetros
hDevice
Identificador del dispositivo de visualización (contexto de gráficos).
unnamedParam2
pData [in, out]
Puntero a una estructura D3DDDIARG_CREATEQUERY que identifica la consulta.
Valor devuelto
CreateQuery devuelve uno de los siguientes valores:
| código de retorno | descripción |
|---|---|
| S_OK | La consulta se crea correctamente. |
| E_OUTOFMEMORY | CreateQuery no pudo asignar la memoria necesaria para que se complete. |
Observaciones
El tiempo de ejecución de Direct3D llama a la función createQuery del controlador de visualización en modo de usuario con un tipo de consulta para crear recursos para una consulta. El controlador de visualización en modo de usuario crea los siguientes recursos para los tipos de consulta:
- BOOL para D3DDDIQUERYTYPE_EVENT. Antes de responder sobre un evento, el controlador debe asegurarse de que la unidad de procesamiento de gráficos (GPU) haya terminado de procesar todas las operaciones relacionadas con el evento. Es decir, el controlador responde sobre un evento después de que se produzca el estado de finalización del problema. El controlador siempre debe establecer el valor BOOL del evento en TRUE al responder.
- UINT para D3DDDIQUERYTYPE_OCCLUSION. El controlador establece esta variable UINT en el número de píxeles para los que se pasó la prueba z para todos los primitivos entre los estados inicial y final de la consulta de problema. Si el búfer de profundidad es multimuestreo, el controlador determina el número de píxeles del número de muestras. Sin embargo, si el dispositivo de pantalla es capaz de precisión z-test para cada multisample, la conversión al número de píxeles generalmente debe redondearse hacia arriba. Después, una aplicación puede comprobar el resultado de la oclusión con respecto a 0, para significar eficazmente "totalmente ocluido". Los controladores que convierten cantidades de muestreo múltiple en cantidades de píxeles deben detectar cambios de muestreo múltiple de destino de representación y seguir calculando los resultados de la consulta correctamente.
- Estructura D3DDDIDEVINFO_VCACHE para D3DDDIQUERYTYPE_VCACHE. El controlador responde después de que se produzca el estado de finalización del problema.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dumddi.h (incluya D3dumddi.h) |