D3D10DDIARG_OPENADAPTER Struktur (d3d10umddi.h)

Die D3D10DDIARG_OPENADAPTER-Struktur beschreibt das Grafikadapterobjekt.

Syntax

typedef struct D3D10DDIARG_OPENADAPTER {
  [in]  D3D10DDI_HRTADAPTER           hRTAdapter;
  [out] D3D10DDI_HADAPTER             hAdapter;
  [in]  UINT                          Interface;
  [in]  UINT                          Version;
  [in]  const D3DDDI_ADAPTERCALLBACKS *pAdapterCallbacks;
  union {
    [out] D3D10DDI_ADAPTERFUNCS   *pAdapterFuncs;
    [out] D3D10_2DDI_ADAPTERFUNCS *pAdapterFuncs_2;
  };
} D3D10DDIARG_OPENADAPTER;

Member

[in] hRTAdapter

Ein Handle für das Grafikkartenobjekt, das das Handle angibt, das der Treiber zum Abfragen von Grafikkartenfunktionen verwenden soll, wenn der Treiber die vom Microsoft Direct3D Runtime bereitgestellte PfnQueryAdapterInfoCb-Rückruffunktion aufruft .

[out] hAdapter

Ein Handle für das Grafikkartenobjekt, das das Handle angibt, das die Direct3D-Runtime in nachfolgenden Treiberaufrufen verwendet, um das Grafikadapterobjekt zu identifizieren. Der Treiber generiert ein eindeutiges Handle und übergibt es zurück an die Direct3D-Runtime.

[in] Interface

Die Direct3D-Schnittstellenversion. Die hohen 16 Bits speichern die Hauptversionsnummer (z. B. 10, 11 usw.); die niedrigen 16 Bits speichern die Nebenfreigabenummer (z. B. 0, 1, 2 usw.). Die Nebenversionsnummer wird erhöht, wenn eine Änderung an der Schnittstelle veröffentlicht wird.

[in] Version

Eine Zahl, die der Treiber verwenden kann, um zu identifizieren, wann die Direct3D-Runtime erstellt wurde. Die hohen 16 Bits stellen die Buildnummer dar; die niedrigen 16 Bits stellen die Revisionsnummer dar.

Der Treiber ist nur erforderlich, um die hohen 16 Bits zu überwachen. Der Treiber sollte sicherstellen, dass die übergebene Runtimebuildversion größer oder gleich der aktuellen Buildversion des Treibers ist. Der Treiber sollte einen Fehler von seiner OpenAdapter10-Funktion zurückgeben, wenn die in der Buildversion übergebene inkompatibel ist.

[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 D3D10DDI_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] pAdapterFuncs_2

Unterstützt in Windows 7 und höheren Versionen.

Ein Zeiger auf eine D3D10_2DDI_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.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile d3d10umddi.h (einschließlich D3d10umddi.h)

Weitere Informationen

D3D10DDI_ADAPTERFUNCS

D3D10_2DDI_ADAPTERFUNCS

D3DDDI_ADAPTERCALLBACKS

OpenAdapter10

pfnQueryAdapterInfoCb