DXGKDDI_CREATEDEVICE Rückruffunktion (d3dkmddi.h)

  • Artikel

Die DXGKDDI_CREATEDEVICE-Funktion erstellt ein Grafikkontextgerät, das anschließend in Aufrufen der gerätespezifischen Funktionen des Anzeigeminiporttreibers verwendet wird.

Syntax

DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;

NTSTATUS DxgkddiCreatedevice(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_CREATEDEVICE pCreateDevice
)
{...}

Parameter

hAdapter

[in] Ein Handle für einen Kontextblock, der einer Grafikkarte zugeordnet ist. Der Anzeige-Miniporttreiber hat dieses Handle zuvor für Dxgkrnl im MiniportDeviceContext-Ausgabeparameter der funktion DXGKDDI_ADD_DEVICE bereitgestellt.

pCreateDevice

[in/out] Zeiger auf eine DXGKARG_CREATEDEVICE Struktur, die das Grafikkontextgerät beschreibt.

Rückgabewert

DXGKDDI_CREATEDEVICE gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS DXGKDDI_CREATEDEVICE das Grafikkontextgerät erfolgreich erstellt.
STATUS_NO_MEMORY DXGKDDI_CREATEDEVICE konnte keinen Speicher zuordnen, der für den Abschluss erforderlich war.

Hinweise

Dxgkrnl ruft die DXGKDDI_CREATEDEVICE-Funktion des Anzeigeminiporttreibers auf, um ein Grafikkontextgerät zu erstellen, das das Grafiksubsystem anschließend in Aufrufen an den Display-Miniporttreiber übergibt. Der Treiber verwendet ein Gerät, um eine Sammlung des Renderingzustands zu enthalten. Das Grafiksubsystem kann mehrere Geräte im selben Prozess auf einem bestimmten GPU-Adapter (Graphics Processing Unit) erstellen.

Hinweis

Die Anzahl von Geräten, die gleichzeitig vorhanden sein können, ist nur durch den verfügbaren Systemspeicher begrenzt. Das heißt, ein Treiber kann kein hartcodiertes maximales Gerätelimit aufweisen.

Im Allgemeinen sind Geräte unabhängig voneinander; Anders ausgedrückt: Auf Ressourcen, die auf einem Gerät erstellt werden, kann nicht auf Ressourcen verwiesen werden, die auf einem anderen Gerät erstellt werden. Prozessübergreifende Ressourcen sind jedoch eine Ausnahme von dieser Regel.

DXGKDDI_CREATEDEVICE sollte als ausserstellbar gemacht werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Zielplattform Desktop
Kopfzeile d3dkmddi.h
IRQL PASSIVE_LEVEL

Weitere Informationen

DXGKARG_CREATEDEVICE

DXGKDDI_ADD_DEVICE