DXGKDDI_CREATEDEVICE Rückruffunktion (d3dkmddi.h)
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 DxgiDdiAddDevice-Funktion 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 |