DD_GETD3DQUERYDATA structure (d3dhal.h)

Article
02/23/2024

DirectX 9.0 et versions ultérieures uniquement.

DD_GETD3DQUERYDATA est la structure de données pointée par le champ lpvData de DD_GETDRIVERINFODATA pour les requêtes DD_GETDRIVERINFO2DATA avec le type D3DGDI2_TYPE_GETD3DQUERY.

Syntaxe

typedef struct _DD_GETD3DQUERYDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  union {
    DWORD        dwQueryIndex;
    D3DQUERYTYPE QueryType;
  };
} DD_GETD3DQUERYDATA;

Membres

gdi2

Spécifie une structure DD_GETDRIVERINFO2DATA qui contient les données GetDriverInfo2 .

dwQueryIndex

Spécifie l’index du type de requête à retourner.

QueryType

Reçoit une valeur de l’énumération D3DQUERYTYPE qui spécifie la fonctionnalité de requête réelle.

Remarques

Le runtime identifie le type de requête à retourner avec un index entier dont la valeur varie entre zéro et un de moins que le nombre de types de requête pris en charge qui ont été signalés précédemment par le pilote dans une requête D3DGDI2_TYPE_GETD3DQUERYCOUNT. La façon dont ces index sont mappés aux types de requête réels est laissée au pilote. Toutefois, chaque index doit être mappé de manière unique à un type de requête pris en charge. L’ordre dans lequel les types de requête sont signalés n’est pas significatif.

Lors du traitement de cette demande GetDriverInfo2 , le pilote doit lire la valeur dans l’union comme s’il s’agissait du membre dwQueryIndex et mapper cette valeur à l’un des types de requête pris en charge (probablement en utilisant la valeur dans dwQueryIndex comme index dans un tableau de valeurs D3DQUERYTYPE). Le pilote doit ensuite copier ce type de requête dans l’union comme s’il s’agissait du membre QueryType . Le runtime garantit qu’il transmet uniquement un index au pilote compris entre zéro et un de moins que le nombre de types de requêtes signalés par le pilote. La plage de l’index doit être validée dans la build du pilote de débogage.

Pour plus d’informations sur D3DQUERYTYPE, consultez la documentation du Kit de développement logiciel (SDK) DirectX.