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 [in, out]

Um ponteiro para uma estrutura D3DDDIARG_GETQUERYDATA que contém as informações sobre a consulta que é recuperada do driver.

Retornar valor

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.

Comentários

O runtime do Microsoft Direct3D pode chamar GetQueryData a qualquer momento depois de chamar a função IssueQuery do driver de exibição no modo de usuário. O driver de exibição do modo de usuário deve marcar o valor de limite atual em relação ao valor armazenado na estrutura de consulta privada do driver para determinar se o problema de consulta foi 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 tratadas por runtime e expor uma versão DDI de 0x0000000B ou superior, o runtime chamará GetQueryData de maneira reentrante. O driver retorna o valor da versão DDI no membro DriverVersion 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 de GetQueryData enquanto outro thread que faz referência ao mesmo dispositivo de exibição é executado dentro de outra função de driver de exibição no modo de usuário.

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_GETQUERYDATA

D3DDDI_DEVICEFUNCS

IssueQuery