Compartilhar via


PFND3D10DDI_QUERYBEGIN função de retorno de chamada (d3d10umddi.h)

A função QueryBegin marca o início de uma sequência de comandos gráficos para uma consulta e faz a transição da consulta para o estado "building".

Sintaxe

PFND3D10DDI_QUERYBEGIN Pfnd3d10ddiQuerybegin;

void Pfnd3d10ddiQuerybegin(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HQUERY unnamedParam2
)
{...}

Parâmetros

unnamedParam1

hDevice [in]

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

unnamedParam2

hQuery [in]

Um identificador para o objeto de consulta a ser iniciado.

Retornar valor

Nenhum

Comentários

O driver pode usar a função de retorno de chamada pfnSetErrorCb para definir um código de erro.

O driver não é necessário para dar suporte à função QueryBegin para uma operação de consulta D3D10DDI_QUERY_EVENT ou D3D10DDI_QUERY_TIMESTAMP. Essa operação de consulta tem um começo implícito.

O runtime do Microsoft Direct3D não pode chamar QueryBegin em um predicado que está atualmente associado ao pipeline por meio de uma chamada para a função SetPredication .

O driver não deve encontrar nenhum erro, exceto para D3DDDIERR_DEVICEREMOVED. Portanto, se o driver passar qualquer erro, exceto por D3DDDIERR_DEVICEREMOVED, em uma chamada para a função pfnSetErrorCb , o runtime do Direct3D determinará que o erro é crítico. Mesmo que o dispositivo tenha sido removido, o driver não precisará retornar D3DDDIERR_DEVICEREMOVED; no entanto, se a remoção do dispositivo interferiu na operação de QueryBegin (o que normalmente não deve acontecer), o driver poderá retornar D3DDDIERR_DEVICEREMOVED.

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 d3d10umddi.h (inclua D3d10umddi.h)

Confira também

D3D10DDI_DEVICEFUNCS

QueryEnd

SetPredication

pfnSetErrorCb