estrutura D3DHAL_DP2CREATEQUERY (d3dhal.h)

Artigo
02/06/2025

Somente versões posteriores e DirectX 9.0.

Uma ou mais estruturas de D3DHAL_DP2CREATEQUERY são analisadas do buffer de comando pelo D3dDrawPrimitives2 retorno de chamada quando o membro bCommand da estrutura D3DHAL_DP2COMMAND está definido como D3DDP2OP_CREATEQUERY e é usado para criar recursos para consultas.

Sintaxe

typedef struct _D3DHAL_DP2CREATEQUERY {
  DWORD        dwQueryID;
  D3DQUERYTYPE QueryType;
} D3DHAL_DP2CREATEQUERY;

Membros

dwQueryID

Identifica a consulta.

QueryType

Especifica um valor da enumeração D3DQUERYTYPE que indica o recurso de consulta para o qual o driver cria recursos.

Observações

O runtime usa D3DHAL_DP2CREATEQUERY para identificar cada consulta com um identificador exclusivo e um tipo de consulta. O retorno de chamada D3dDrawPrimitives2 do driver deve processar estruturas de D3DHAL_DP2CREATEQUERY wPrimitiveCount do buffer de comando. O valor de wPrimitiveCount é especificado na estrutura D3DHAL_DP2COMMAND. O driver analisa essas estruturas e cria recursos para as consultas que elas representam conforme necessário.

O driver cria recursos para os seguintes tipos de consulta:

BOOL para D3DQUERYTYPE_EVENT. Antes de responder com D3DDP2OP_RESPONSEQUERY para um evento, o driver deve garantir que a GPU (unidade de processamento de elementos gráficos) esteja concluída processando todas as operações D3DHAL_DP2OPERATION relacionadas ao evento. Ou seja, o driver só responde após o estado de ISSUE_END do evento. O driver sempre deve definir o valor BOOL do evento para verdadeiro ao responder.
DWORD para D3DQUERYTYPE_OCCLUSION. O driver define esse DWORD como o número de pixels para os quais o teste z passou para todos os primitivos entre o início e o final da consulta. Se o buffer de profundidade for multisamplado, o driver determinará o número de pixels do número de amostras. No entanto, se o dispositivo de exibição for capaz de precisão de teste z por multisampla, a conversão em número de pixels geralmente deverá ser arredondada para cima. Em seguida, um aplicativo pode verificar o resultado da oclusão em relação a 0, para efetivamente significar "totalmente occluded". Os drivers que convertem quantidades multiplataformas em quantidades de pixel devem detectar alterações multisampling de destino de renderização e continuar a calcular os resultados da consulta adequadamente.
D3DDEVINFO_VCACHE estrutura para D3DQUERYTYPE_VCACHE.