DXGKDDI_CREATECONTEXT Rückruffunktion (d3dkmddi.h)

Die DxgkDdiCreateContext-Funktion erstellt einen GPU-Kontext (Graphics Processing Unit).

Syntax

DXGKDDI_CREATECONTEXT DxgkddiCreatecontext;

NTSTATUS DxgkddiCreatecontext(
  [in]     IN_CONST_HANDLE hDevice,
  [in/out] INOUT_PDXGKARG_CREATECONTEXT pCreateContext
)
{...}

Parameter

[in] hDevice

Ein Handle für das Grafikkontextgerät, auf dem der neue Kontext erstellt wird. Die DxgkDdiCreateDevice-Funktion des Anzeigeminiporttreibers hat dieses Handle zuvor für das Microsoft DirectX-Grafikkernsubsystem im hDevice-Member der DXGKARG_CREATEDEVICE-Struktur bereitgestellt.

[in/out] pCreateContext

Ein Zeiger auf eine DXGKARG_CREATECONTEXT-Struktur , die Informationen zum Erstellen des Kontexts enthält.

Rückgabewert

DxgkDdiCreateContext gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	DxgkDdiCreateContext hat den Kontext erfolgreich erstellt.
STATUS_NO_MEMORY	DxgkDdiCreateContext konnte keinen Speicher zuordnen, der für die Vervollständigung erforderlich war.
STATUS_GRAPHICS_DRIVER_MISMATCH	Der Anzeigeminiporttreiber ist nicht mit dem Anzeigetreiber für den Benutzermodus kompatibel, der den Aufruf von DxgkDdiCreateContext initiiert hat.

Hinweise

Ein Treiber verwendet einen GPU-Kontext, um eine Auflistung des Renderingzustands zu enthalten.

Ein einzelner Prozess kann mehrere Kontexte auf einem bestimmten Gerät erstellen.

Der Treiber muss eine beliebige Anzahl von Kontexten unterstützen. Der einzige gültige Grund, warum ein Treiber keinen Kontext erstellen konnte, ist, wenn der Systemspeicher ausläuft.

In der Regel kann jeder Kontext auf jede Ressource verweisen, die zuvor für das Gerät erstellt wurde, das diesen Kontext besitzt.

DxgkDdiCreateContext sollte seitenfähig gemacht werden.

Anforderungen

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

Weitere Informationen

DXGKARG_CREATECONTEXT

DXGKARG_CREATEDEVICE

DxgkDdiCreateDevice