PFND3DDDI_CREATEQUERY função de retorno de chamada (d3dumddi.h)
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 [dentro, fora]
Um ponteiro para uma estrutura D3DDDIARG_CREATEQUERY que identifica a consulta.
Valor de retorno
CreateQuery retorna um dos seguintes valores:
| Código de retorno | descrição |
|---|---|
| S_OK | A consulta é criada com êxito. |
| E_OUTOFMEMORY | CreateQuery não pôde alocar a memória necessária para que ela fosse concluída. |
Observações
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 do 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 de elementos gráficos) esteja concluída processando todas as operações relacionadas ao evento. Ou seja, o driver responde sobre um evento depois que o estado final do problema ocorre. O driver sempre deve definir o valor BOOL do evento para verdadeiro 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 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 para cada 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.
- Uma estrutura D3DDDIDEVINFO_VCACHE para D3DDDIQUERYTYPE_VCACHE. O driver responde após o estado final do problema.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |