D3DDDIARG_CREATEDEVICE-Struktur (d3dumddi.h)
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) |