D3DDDIARG_OPENADAPTER Struktur (d3dumddi.h)

Artikel
08/07/2023

Die D3DDDIARG_OPENADAPTER-Struktur enthält Informationen, die das Grafikadapterobjekt beschreiben.

Syntax

typedef struct _D3DDDIARG_OPENADAPTER {
  [in/out] HANDLE                        hAdapter;
  [in]     UINT                          Interface;
  [in]     UINT                          Version;
  [in]     const D3DDDI_ADAPTERCALLBACKS *pAdapterCallbacks;
  [out]    D3DDDI_ADAPTERFUNCS           *pAdapterFuncs;
  [out]    UINT                          DriverVersion;
} D3DDDIARG_OPENADAPTER;

Member

[in/out] hAdapter

Ein Handle für das Grafikadapterobjekt. Bei der Eingabe an die OpenAdapter-Funktion gibt hAdapter das Handle an, das der Treiber zum Abfragen von Grafikkartenfunktionen verwenden soll, wenn der Treiber die vom Microsoft Direct3D-Runtime bereitgestellte PfnQueryAdapterInfoCb-Rückruffunktion aufruft .

Der Treiber generiert ein eindeutiges Handle und übergibt es zurück an die Direct3D-Runtime. Bei der Ausgabe der OpenAdapter-Funktion gibt hAdapter das Handle an, das die Direct3D-Runtime in nachfolgenden Treiberaufrufen verwendet, um das Grafikadapterobjekt zu identifizieren.

[in] Interface

Die Direct3D/DirectDraw-Schnittstellenversion (z. B. 7, 8 oder 9), die den Grafikkarten öffnet.

[in] Version

Eine Zahl, die der Treiber verwenden kann, um zu identifizieren, wann die Direct3D/DirectDraw-Runtime erstellt wurde. Beispielsweise kann der Treiber die Versionsnummer verwenden, um zwischen einer Runtime zu unterscheiden, die mit Windows Vista veröffentlicht wird, und einer Runtime, die mit einem nachfolgenden Service Pack veröffentlicht wird, das möglicherweise einen Vom Treiber benötigten Fix enthalten kann.

[in] pAdapterCallbacks

Ein Zeiger auf eine D3DDDI_ADAPTERCALLBACKS-Struktur , die die vom Treiber verwendete Rückruffunktion pfnQueryAdapterInfoCb enthält.

[out] pAdapterFuncs

Ein Zeiger auf eine D3DDDI_ADAPTERFUNCS Struktur, die eine Tabelle mit Benutzermodus-Anzeigetreiberadapter-spezifischen Funktionen enthält. Die Direct3D-Runtime verwendet diese Funktionen, um mit dem Benutzermodusanzeigetreiber über Vorgänge zu kommunizieren, die für den Grafikkarten spezifisch sind.

[out] DriverVersion

Die Version der Direct3D-Benutzermodusanzeigetreiberschnittstelle, die aus der Headerdatei D3dumddi.h abgerufen wurde, mit der der Treiber kompiliert wurde. Der Benutzermodusanzeigetreiber sollte D3D_UMD_INTERFACE_VERSION zurückgeben.

Hinweis Wenn ein Benutzermodustreiber keine Windows 7-Features (DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7) unterstützt und Sie den Treiber mit dem Windows 7 WDK (Version 7600) kompilieren möchten, stellen Sie sicher, dass der Treiber D3D_UMD_INTERFACE_VERSION_VISTA zurückgibt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	d3dumddi.h (include D3dumddi.h)

Weitere Informationen

D3DDDI_ADAPTERCALLBACKS

D3DDDI_ADAPTERFUNCS

OpenAdapter

pfnQueryAdapterInfoCb

Freigeben über