PFND3DDDI_CREATEQUERY função de retorno de chamada (d3dumddi.h)

  • Artigo

A função CreateQuery cria recursos do lado do driver para uma consulta que o runtime do Microsoft Direct3D emite posteriormente para processamento.

Sintaxe

PFND3DDDI_CREATEQUERY Pfnd3dddiCreatequery;

HRESULT Pfnd3dddiCreatequery(
  HANDLE hDevice,
  D3DDDIARG_CREATEQUERY *unnamedParam2
)
{...}

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (contexto gráfico).

unnamedParam2

pData [in, out]

Um ponteiro para uma estrutura D3DDDIARG_CREATEQUERY que identifica a consulta.

Retornar valor

CreateQuery retorna um dos seguintes valores:

Código de retorno Descrição
S_OK A consulta foi criada com êxito.
E_OUTOFMEMORY CreateQuery não pôde alocar a memória necessária para que ela fosse concluída.

Comentários

O runtime do Direct3D chama a função CreateQuery do driver de exibição do modo de usuário com um tipo de consulta para criar recursos para uma consulta. O driver de exibição no modo de usuário cria os seguintes recursos para tipos de consulta:

  • BOOL para D3DDDIQUERYTYPE_EVENT. Antes de responder sobre um evento, o driver deve garantir que a GPU (unidade de processamento gráfico) esteja concluída processando todas as operações relacionadas ao evento. Ou seja, o driver responde sobre um evento após o estado final do problema ocorrer. O driver sempre deve definir o valor BOOL do evento como TRUE ao responder.
  • UINT para D3DDDIQUERYTYPE_OCCLUSION. O driver define essa variável UINT como o número de pixels para os quais o teste z passou para todos os primitivos entre os estados inicial e final da consulta de problema. Se o buffer de profundidade for multisampled, 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 z-test para cada multisampla, a conversão em número de pixels geralmente deverá ser arredondada. Em seguida, um aplicativo pode marcar o resultado de oclusão contra 0, para efetivamente significar "totalmente ocluído". Os drivers que convertem quantidades multisamplos em quantidades de pixels devem detectar alterações de multisampling de destino de renderização e continuar a calcular os resultados da consulta adequadamente.
  • Uma estrutura D3DDDIDEVINFO_VCACHE para D3DDDIQUERYTYPE_VCACHE. O driver responde depois que o estado final do problema ocorre.
Para obter mais informações sobre os estados de consulta de problema, consulte D3DDDI_ISSUEQUERYFLAGS.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho d3dumddi.h (inclua D3dumddi.h)

Confira também

D3DDDIARG_CREATEQUERY

D3DDDIDEVINFO_VCACHE

D3DDDI_DEVICEFUNCS

D3DDDI_ISSUEQUERYFLAGS