PFND3DDDI_GETQUERYDATA funzione di callback (d3dumddi.h)

La funzione GetQueryData recupera informazioni su una query.

Sintassi

PFND3DDDI_GETQUERYDATA Pfnd3dddiGetquerydata;

HRESULT Pfnd3dddiGetquerydata(
  HANDLE hDevice,
  const D3DDDIARG_GETQUERYDATA *unnamedParam2
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

pData [in, out]

Puntatore a una struttura D3DDDIARG_GETQUERYDATA che contiene le informazioni sulla query recuperata dal driver.

Valore restituito

GetQueryData restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	L'operazione di query è stata completata e il risultato della query è disponibile.
S_FALSE	GetQueryData restituito correttamente. Tuttavia, l'operazione di query non è stata completata, pertanto il risultato della query non è disponibile.
E_OUTOFMEMORY	GetQueryData non è riuscito a allocare la memoria necessaria per il completamento.

Commenti

Il runtime di Microsoft Direct3D può chiamare GetQueryData in qualsiasi momento dopo aver chiamato la funzione IssueQuery del driver in modalità utente. Il driver di visualizzazione in modalità utente deve controllare il valore di recinzione corrente rispetto al valore archiviato nella struttura di query privata del driver per determinare se il problema di query è stato completato.

Se la query viene completata, il driver deve restituire S_OK; in caso contrario, il driver deve restituire S_FALSE.

Se un driver supporta le ottimizzazioni multiple-processori gestite dal runtime ed espone una versione DDI di 0x0000000B o successiva, il runtime chiamerà GetQueryData in modo reentrant. Il driver restituisce il valore DDI-version nel membro DriverVersion della struttura D3D10DDIARG_OPENADAPTER in una chiamata alla funzione OpenAdapter del driver. Quando il runtime chiama GetQueryData in modo reentrant, un thread può essere eseguito all'interno di GetQueryData mentre un altro thread che fa riferimento allo stesso dispositivo visualizzato viene eseguito all'interno di un'altra funzione di driver di visualizzazione in modalità utente.

Requisiti

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

Vedi anche

D3DDDIARG_GETQUERYDATA

D3DDDI_DEVICEFUNCS

IssueQuery