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 pour le périphérique d’affichage (contexte graphique).
unnamedParam2
pData [in, out]
Pointeur vers une structure D3DDDIARG_GETQUERYDATA qui contient les informations sur la requête récupérée à partir du pilote.
Valeur retournée
GetQueryData retourne l’une des valeurs suivantes :
| Code de retour | 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 retourné avec succès. Toutefois, l’opération de requête n’étant pas terminée, le résultat de la requête n’est pas disponible. |
| E_OUTOFMEMORY | GetQueryData n’a pas pu allouer la mémoire nécessaire pour qu’il 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 case activée 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 les optimisations à 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 dans 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | d3dumddi.h (inclure D3dumddi.h) |