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) |