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 zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniporttreiber hat dieses Handle zuvor für Dxgkrnl- im MiniportDeviceContext Ausgabeparameters der DxgiDdiAddDevice--Funktion bereitgestellt.
pCreateDevice
[in/out] Zeigen Sie 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. |
Bemerkungen
Dxgkrnl- ruft die DXGKDDI_CREATEDEVICE-Funktion des Anzeigeminiporttreibers auf, um ein Grafikkontextgerät zu erstellen, das das Grafiksubsystem anschließend Aufrufe an den Anzeigeminiporttreiber ü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.
Anmerkung
Die Anzahl der Geräte, die gleichzeitig vorhanden sein können, ist nur durch den verfügbaren Systemspeicher begrenzt. Das heißt, ein Treiber darf keine hartcodierte maximale Gerätegrenze aufweisen.
Im Allgemeinen sind Geräte voneinander unabhängig; Mit anderen Worten: Auf Ressourcen, die auf einem Gerät erstellt werden, kann nicht auf Ressourcen verwiesen oder darauf zugegriffen werden, die auf einem anderen Gerät erstellt werden. Prozessübergreifende Ressourcen sind jedoch eine Ausnahme von dieser Regel.
DXGKDDI_CREATEDEVICE sollte seitenfähig gemacht werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h |
| IRQL- | PASSIVE_LEVEL |