DD_GETADAPTERGROUPDATA Struktur (d3dhal.h)

  • Artikel

Nur DirectX 9.0 und höhere Versionen.

DD_GETADAPTERGROUPDATA ist die Datenstruktur, auf die das lpvData-Feld von DD_GETDRIVERINFODATA für DD_GETDRIVERINFO2DATA Abfragen mit dem Typ D3DGDI2_TYPE_GETADAPTERGROUP zeigt.

Syntax

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

Member

gdi2

Gibt eine DD_GETDRIVERINFO2DATA-Struktur an, die die GetDriverInfo2-Daten für die Abfrage enthält.

ulUniqueAdapterGroupId

Empfängt den Bezeichner der Gruppe von Adaptern, die das mehrteilige Video des Treibers Karte. Der Treiber muss einen eindeutigen Bezeichner für die master und alle untergeordneten Adapter innerhalb dieser Gruppe bereitstellen.

dwReserved1

Gibt ein reserviertes Feld an. Der Treiber darf nicht lesen oder schreiben. Auf NULL festlegen.

dwReserved2

Gibt ein reserviertes Feld an. Der Treiber darf nicht lesen oder schreiben. Auf NULL festlegen.

Hinweise

Die Runtime verwendet DD_GETADAPTERGROUPDATA in einer Abfrage für die Identität der Adaptergruppe des Treibers. Diese Gruppe verwendet Videohardware wie Videospeicher und 3D-Beschleuniger. Die Runtime verwendet diese Abfrage hauptsächlich für Dual-View-Grafikkarten. Eine Anwendung kann anfordern, dass Oberflächenressourcen (z. B. Texturen und Vertexpuffer) adapterübergreifend in einer Gruppe gemeinsam genutzt werden, und die Laufzeit entspricht dieser Anforderung.

Der Bezeichner in ulUniqueAdapterGroupId muss treiberübergreifend eindeutig sein, einschließlich Treibern anderer Hardwareanbieter. Daher wird empfohlen, diesen Bezeichner als eindeutige Kernelmodusadresse zu melden, die bei anderen Grafikkarten mit mehreren Köpfen nicht üblich ist. Beachten Sie, dass der Treiber diesen Bezeichner als ungleich null melden muss.

Anforderungen

Anforderung Wert
Header d3dhal.h (include D3dhal.h)

Weitere Informationen

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA