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;
Angehörige
[in/out] hDevice
Ein Handle für das Anzeigegerät (Grafikkontext). Bei Eingaben an die CreateDevice--Funktion gibt hDevice- den Handle an, den der Treiber verwenden soll, wenn er wieder in die Microsoft Direct3D-Laufzeit aufruft.
Der Treiber generiert ein eindeutiges Handle und übergibt es an die Direct3D-Laufzeit zurück. Bei der Ausgabe der CreateDevice--Funktion gibt hDevice- den Handle an, den die Direct3D-Laufzeit in nachfolgenden Treiberaufrufen zum Identifizieren des Anzeigegeräts verwendet.
[in] Interface
Die Direct3D/DirectDraw-Schnittstellenversion (z. B. 7, 8 oder 9), die das Gerät erstellt.
[in] Version
Eine Zahl, mit der der Treiber ermitteln kann, wann die Direct3D/DirectDraw-Laufzeit erstellt wurde. Beispielsweise kann der Treiber die Versionsnummer verwenden, um zwischen einer Laufzeit zu unterscheiden, die mit Windows Vista veröffentlicht wird, und einer Laufzeit, die mit einem nachfolgenden Service Pack veröffentlicht wird, das möglicherweise einen Fix enthalten kann, den der Treiber benötigt.
[in] pCallbacks
Ein Zeiger auf eine D3DDDI_DEVICECALLBACKS Struktur, die eine Tabelle mit Direct3D-Laufzeitrückruffunktionen enthält, die der Treiber verwenden kann.
[in] pCommandBuffer
Obsolet. Um einen Zeiger auf den ersten Puffer zu erhalten, den der Anzeigetreiber für den Benutzermodus für Batchbefehle verwenden kann, muss der Treiber zuerst die pfnCreateContextCb--Funktion aufrufen, um einen Kontext für das neu erstellte Gerät zu erstellen.
[in] CommandBufferSize
Obsolet.
[in] pAllocationList
Obsolet. Um ein Array von D3DDDI_ALLOCATIONLIST Strukturen für die Startzuordnungsliste zu empfangen, muss der Treiber zuerst die pfnCreateContextCb--Funktion aufrufen, um einen Kontext für das neu erstellte Gerät zu erstellen.
[in] AllocationListSize
Obsolet.
[in] pPatchLocationList
Obsolet. Um ein Array von D3DDDI_PATCHLOCATIONLIST Strukturen für die Start-Patch-Location-Liste zu empfangen, muss der Treiber zuerst die pfnCreateContextCb--Funktion aufrufen, um einen Kontext für das neu erstellte Gerät zu erstellen.
[in] PatchLocationListSize
Obsolet.
pDeviceFuncs
[out] Ein Zeiger auf eine D3DDDI_DEVICEFUNCS Struktur, die der Anzeigetreiber im Benutzermodus mit einer Tabelle seiner Funktionen ausfüllt. Die Direct3D-Laufzeit verwendet diese Funktionen, um mit dem Anzeigetreiber für den Benutzermodus zu kommunizieren.
[in] Flags
Eine D3DDDI_CREATEDEVICEFLAGS Struktur, die angibt, wie das Gerät erstellt wird.
CommandBuffer
Dieses Element ist reserviert und sollte auf Null festgelegt werden.
Dieses Mitglied ist ab Windows 7 verfügbar.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Header- | d3dumddi.h (include D3dumddi.h) |