Partager via


structure DD_GETADAPTERGROUPDATA (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 pour la requête.

ulUniqueAdapterGroupId

Reçoit l’identificateur du groupe d’adaptateurs qui composent la carte vidéo à plusieurs têtes du pilote. Le pilote doit fournir un identificateur unique pour le maître 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éfini sur zéro.

dwReserved2

Spécifie un champ réservé. Le pilote ne doit pas lire ou écrire. Défini sur 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 adaptateurs vidéo double affichage. Une application peut demander que les ressources surface (telles que les textures et les mémoires tampons de vertex) soient partagées entre les adaptateurs d’un groupe et que le runtime est 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.

Exigences

Exigence Valeur
d’en-tête d3dhal.h (include D3dhal.h)

Voir aussi

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA