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 tiempo 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 valores siguientes:
| Código devuelto | Descripción |
|---|---|
| S_OK | La consulta se crea correctamente. |
| E_OUTOFMEMORY | CreateQuery no pudo asignar la memoria necesaria para que se complete. |
Comentarios
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 gráfico (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 final 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 ha superado 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 de prueba z para cada multimuestra, la conversión al número de píxeles normalmente se debe redondear hacia arriba. Después, una aplicación puede comprobar el resultado de la oclusión en 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 de D3DDDIDEVINFO_VCACHE para D3DDDIQUERYTYPE_VCACHE. El controlador responde después de que se produzca el estado final del problema.
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) |