DD_GETADAPTERGROUPDATA structure (d3dhal.h)

DirectX 9.0 et versions ultérieures uniquement.

DD_GETADAPTERGROUPDATA 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_GETADAPTERGROUP.

Syntaxe

typedef struct _DD_GETADAPTERGROUPDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  ULONG_PTR             ulUniqueAdapterGroupId;
  DWORD                 dwReserved1;
  DWORD                 dwReserved2;
} DD_GETADAPTERGROUPDATA;

Membres

gdi2

Spécifie une structure DD_GETDRIVERINFO2DATA qui contient les données GetDriverInfo2 de la requête.

ulUniqueAdapterGroupId

Reçoit l’identificateur du groupe d’adaptateurs qui composent le carte vidéo à plusieurs têtes du pilote. Le pilote doit fournir un identificateur unique pour le master et tous les adaptateurs subordonnés au sein de ce groupe.

dwReserved1

Spécifie un champ réservé. Le pilote ne doit pas lire ou écrire. Définit la valeur zéro.

dwReserved2

Spécifie un champ réservé. Le pilote ne doit pas lire ou écrire. Définit la valeur zéro.

Remarques

Le runtime utilise DD_GETADAPTERGROUPDATA dans une requête pour l’identité du groupe d’adaptateurs du pilote. Ce groupe partage du matériel vidéo comme la mémoire vidéo et l’accélérateur 3D. Le runtime utilise principalement cette requête pour les cartes vidéo à double affichage. Une application peut demander que les ressources de surface (telles que les textures et les tampons de vertex) soient partagées entre les adaptateurs d’un groupe et que le runtime soit conforme à cette demande.

L’identificateur dans ulUniqueAdapterGroupId doit être unique entre les pilotes, y compris les pilotes d’autres fournisseurs de matériel. Par conséquent, il est recommandé de signaler cet identificateur en tant qu’adresse unique en mode noyau qui ne peut pas être commune avec d’autres cartes vidéo à plusieurs têtes. Notez que le pilote doit signaler cet identificateur comme différent de zéro.

Configuration requise

Condition requise	Valeur
En-tête	d3dhal.h (inclure D3dhal.h)

Voir aussi

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA