PFND3D10DDI_QUERYBEGIN funzione di callback (d3d10umddi.h)

Articolo
02/22/2024

La funzione QueryBegin contrassegna l'inizio di una sequenza di comandi grafici per una query e passa la query allo stato "building".

Sintassi

PFND3D10DDI_QUERYBEGIN Pfnd3d10ddiQuerybegin;

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

Parametri

unnamedParam1

hDevice [in]

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

hQuery [in]

Handle all'oggetto query da iniziare.

Valore restituito

nessuno

Osservazioni

Il driver può usare la funzione di callback pfnSetErrorCb per impostare un codice di errore.

Il driver non è necessario per supportare la funzione QueryBegin per un'operazione di query D3D10DDI_QUERY_EVENT o D3D10DDI_QUERY_TIMESTAMP. Tale operazione di query ha un inizio implicito.

Il runtime di Microsoft Direct3D non può chiamare QueryBegin in un predicato attualmente associato alla pipeline tramite una chiamata alla funzione SetPredication .

Il driver non deve riscontrare alcun errore, ad eccezione di D3DDDIERR_DEVICEREMOVED. Pertanto, se il driver passa qualsiasi errore, ad eccezione di D3DDDIERR_DEVICEREMOVED, in una chiamata alla funzione pfnSetErrorCb , il runtime Direct3D determinerà che l'errore è critico. Anche se il dispositivo è stato rimosso, il driver non è necessario restituire D3DDDIERR_DEVICEREMOVED; tuttavia, se la rimozione del dispositivo interferisce con l'operazione di QueryBegin (che in genere non dovrebbe verificarsi), il driver può restituire D3DDDIERR_DEVICEREMOVED.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	d3d10umddi.h (include D3d10umddi.h)

Vedi anche