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

  • Artículo

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.
Para obtener más información sobre los estados de consulta de problemas, consulte D3DDDI_ISSUEQUERYFLAGS.

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_CREATEQUERY

D3DDDIDEVINFO_VCACHE

D3DDDI_DEVICEFUNCS

D3DDDI_ISSUEQUERYFLAGS