PFND3DDDI_GETQUERYDATA fonction de rappel (d3dumddi.h)
La fonction GetQueryData récupère des informations sur une requête.
Syntaxe
PFND3DDDI_GETQUERYDATA Pfnd3dddiGetquerydata;
HRESULT Pfnd3dddiGetquerydata(
HANDLE hDevice,
const D3DDDIARG_GETQUERYDATA *unnamedParam2
)
{...}
Paramètres
hDevice
Handle de l’appareil d’affichage (contexte graphique).
unnamedParam2
pData [in, out]
Pointeur vers une structure D3DDDIARG_GETQUERYDATA qui contient les informations relatives à la requête récupérée à partir du pilote.
Valeur de retour
GetQueryData retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| S_OK | L’opération de requête s’est terminée et le résultat de la requête est disponible. |
| S_FALSE | GetQueryData a retourné correctement. Toutefois, l’opération de requête n’a pas terminé, de sorte que le résultat de la requête n’est pas disponible. |
| E_OUTOFMEMORY | GetQueryData n’a pas pu allouer la mémoire requise pour qu’elle se termine. |
Remarques
Le runtime Microsoft Direct3D peut appeler GetQueryData à tout moment après avoir appelé la fonction IssueQuery du pilote d’affichage en mode utilisateur. Le pilote d’affichage en mode utilisateur doit vérifier la valeur de clôture actuelle par rapport à la valeur stockée dans la structure de requête privée du pilote pour déterminer si le problème de requête est terminé.
Si la requête est terminée, le pilote doit retourner S_OK ; sinon, le pilote doit retourner S_FALSE.
Si un pilote prend en charge optimisations de plusieurs processeurs gérés par le runtime et expose une version DDI de 0x0000000B ou supérieure, le runtime appelle GetQueryData de manière réentrante. Le pilote retourne la valeur de version DDI dans le membre DriverVersion de la structure D3D10DDIARG_OPENADAPTER dans un appel à la fonction OpenAdapter du pilote. Lorsque le runtime appelle GetQueryData de manière réentrante, un thread peut s’exécuter à l’intérieur GetQueryData tandis qu’un autre thread qui référence le même périphérique d’affichage s’exécute à l’intérieur d’une autre fonction de pilote d’affichage en mode utilisateur.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | d3dumddi.h (include D3dumddi.h) |