PFND3DDDI_GETQUERYDATA função de retorno de chamada (d3dumddi.h)
A função GetQueryData recupera informações sobre uma consulta.
Sintaxe
PFND3DDDI_GETQUERYDATA Pfnd3dddiGetquerydata;
HRESULT Pfnd3dddiGetquerydata(
HANDLE hDevice,
const D3DDDIARG_GETQUERYDATA *unnamedParam2
)
{...}
Parâmetros
hDevice
Um identificador para o dispositivo de exibição (contexto gráfico).
unnamedParam2
pData [dentro, fora]
Um ponteiro para uma estrutura de D3DDDIARG_GETQUERYDATA que contém as informações sobre a consulta recuperada do driver.
Valor de retorno
GetQueryData retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | A operação de consulta foi concluída e o resultado da consulta está disponível. |
| S_FALSE | GetQueryData retornou com êxito. No entanto, a operação de consulta não foi concluída, portanto, o resultado da consulta não está disponível. |
| E_OUTOFMEMORY | GetQueryData não pôde alocar a memória necessária para que ela fosse concluída. |
Observações
O runtime do Microsoft Direct3D pode chamar GetQueryData a qualquer momento depois de chamar a função de do do driver de exibição do modo de usuário. O driver de exibição do modo de usuário deve verificar o valor de cerca atual em relação ao valor armazenado na estrutura de consulta privada do driver para determinar se o problema da consulta está concluído.
Se a consulta for concluída, o driver deverá retornar S_OK; caso contrário, o driver deve retornar S_FALSE.
Se um driver der suporte a otimizações de vários processadores com runtime e expor uma versão DDI de 0x0000000B ou superior, o runtime chamará GetQueryData de maneira reentrada. O driver retorna o valor da versão DDI no driverVersion membro da estrutura D3D10DDIARG_OPENADAPTER em uma chamada para a função OpenAdapter do driver. Quando o runtime chama GetQueryData de maneira reentrante, um thread pode ser executado dentro GetQueryData enquanto outro thread que referencia o mesmo dispositivo de exibição é executado dentro de outra função de driver de exibição no modo de usuário.
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) |