D3DDDIARG_CREATEDEVICE-Struktur (d3dumddi.h)

  • Artikel

Die D3DDDIARG_CREATEDEVICE-Struktur enthält Informationen, die das zu erstellende Anzeigegerät beschreiben.

Syntax

typedef struct _D3DDDIARG_CREATEDEVICE {
  [in/out] HANDLE                       hDevice;
  [in]     UINT                         Interface;
  [in]     UINT                         Version;
  [in]     const D3DDDI_DEVICECALLBACKS *pCallbacks;
  [in]     VOID                         *pCommandBuffer;
  [in]     UINT                         CommandBufferSize;
  [in]     D3DDDI_ALLOCATIONLIST        *pAllocationList;
  [in]     UINT                         AllocationListSize;
  [in]     D3DDDI_PATCHLOCATIONLIST     *pPatchLocationList;
  [in]     UINT                         PatchLocationListSize;
           D3DDDI_DEVICEFUNCS           *pDeviceFuncs;
  [in]     D3DDDI_CREATEDEVICEFLAGS     Flags;
           D3DGPU_VIRTUAL_ADDRESS       CommandBuffer;
} D3DDDIARG_CREATEDEVICE;

Member

[in/out] hDevice

Ein Handle für das Anzeigegerät (Grafikkontext). Bei der Eingabe der CreateDevice-Funktion gibt hDevice das Handle an, das der Treiber verwenden soll, wenn er die Microsoft Direct3D-Runtime zurückruft.

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

[in] Interface

Die Direct3D/DirectDraw-Schnittstellenversion (z. B. 7, 8 oder 9), die das Gerät erstellt.

[in] Version

Eine Zahl, die der Treiber verwenden kann, um zu identifizieren, wann die Direct3D/DirectDraw-Runtime erstellt wurde. Der Treiber kann z. B. 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 Fix enthält, den der Treiber benötigt.

[in] pCallbacks

Ein Zeiger auf eine D3DDDI_DEVICECALLBACKS-Struktur , die eine Tabelle mit Direct3D-Runtime-Rückruffunktionen enthält, die der Treiber verwenden kann.

[in] pCommandBuffer

Veraltet. Um einen Zeiger auf den ersten Puffer zu erhalten, den der Benutzermodusanzeigetreiber zum Batchen von Befehlen verwenden kann, muss der Treiber zuerst die PfnCreateContextCb-Funktion aufrufen, um einen Kontext für das neu erstellte Gerät zu erstellen.

[in] CommandBufferSize

Veraltet.

[in] pAllocationList

Veraltet. Um ein Array von D3DDDI_ALLOCATIONLIST Strukturen für die Startzuordnungsliste zu erhalten, muss der Treiber zuerst die PfnCreateContextCb-Funktion aufrufen, um einen Kontext für das neu erstellte Gerät zu erstellen.

[in] AllocationListSize

Veraltet.

[in] pPatchLocationList

Veraltet. Um ein Array von D3DDDI_PATCHLOCATIONLIST Strukturen für die Startliste für patch-location zu erhalten, muss der Treiber zuerst die PfnCreateContextCb-Funktion aufrufen, um einen Kontext für das neu erstellte Gerät zu erstellen.

[in] PatchLocationListSize

Veraltet.

pDeviceFuncs

[out] Ein Zeiger auf eine D3DDDI_DEVICEFUNCS Struktur, die der Benutzermodusanzeigetreiber mit einer Tabelle seiner Funktionen auffüllt. Die Direct3D-Runtime verwendet diese Funktionen, um mit dem Benutzermodus-Anzeigetreiber zu kommunizieren.

[in] Flags

Eine D3DDDI_CREATEDEVICEFLAGS-Struktur , die angibt, wie das Gerät erstellt wird.

CommandBuffer

Dieser Member ist reserviert und sollte auf 0 (null) festgelegt werden.

Dieses Mitglied ist ab Windows 7 verfügbar.

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

CreateDevice

D3DDDI_CREATEDEVICEFLAGS

D3DDDI_DEVICECALLBACKS

D3DDDI_DEVICEFUNCS

DxgkDdiCreateDevice