PFND3DDDI_GETQUERYDATA fonction de rappel (d3dumddi.h)

  • Article

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)

Voir aussi

D3DDDIARG_GETQUERYDATA

D3DDDI_DEVICEFUNCS

IssueQuery