Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Befehl DxgkDdiSubmitCommandVirtual sendet einen DMA-Puffer an einen Kontext, der die virtuelle Adressierung unterstützt.
Syntax
DXGKDDI_SUBMITCOMMANDVIRTUAL DxgkddiSubmitcommandvirtual;
NTSTATUS DxgkddiSubmitcommandvirtual(
IN_CONST_HANDLE hAdapter,
IN_CONST_PDXGKARG_SUBMITCOMMANDVIRTUAL pSubmitCommand
)
{...}
Parameter
hAdapter
Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniporttreiber (KMD) hat dieses Handle zuvor für Dxgkrnl im Ausgabeparameter MiniportDeviceContext der DxgkDdiAddDevice-Funktion bereitgestellt.
pSubmitCommand
Ein Zeiger auf eine DXGKARG_SUBMITCOMMANDVIRTUAL Struktur, die den Vorgang beschreibt.
Rückgabewert
| Wert | Beschreibung |
|---|---|
| STATUS_ERFOLGREICH | Der übermittelte Befehl ist wohlgeformt. |
| STATUS_INVALID_PARAMETER | Die DMA- oder privaten Daten werden als fehlerhaft festgelegt. In diesem Fall setzt das Betriebssystem das aufrufende Gerät in einen Fehlerzustand ein, und alle nachfolgenden Aufrufe werden fehlschlagen. Der SubmissionFenceId- an diesen Aufruf übergebene Wert wird als abgeschlossen betrachtet, nachdem alle vorherigen Pakete auf der Hardware abgeschlossen sind, und zu diesem Zeitpunkt sollte der Treiberbegriff der letzten abgeschlossenen Zaun-ID auf diesen Wert aktualisiert werden. Dieses Verhalten unterscheidet sich von einem Aufruf vonDxgkDdiSubmitCommand, bei dem aufgrund der Möglichkeit zum Überprüfen der Daten in einem vorherigen DxgkDdiRender-Aufruf kein Fehler zurückgegeben werden darf. |
Alle anderen Rückgabewerte führen zu einer Betriebssystemfehlerüberprüfung.
Bemerkungen
DxgkDdiSubmitCommandVirtual arbeitet mit virtueller Speicheradressierung, während DxgkDdiSubmitCommand mit physischem Arbeitsspeicher aufgerufen wird. DxgkDdiSubmitCommandVirtual ermöglicht es dem Treiber, den Speicher flexibler zu verwalten.
Möglicherweise hat die GPU zuvor mit einem anderen Adressraum gearbeitet, z. B. für einen anderen Prozess oder Kontext. Der Treiber ist dafür verantwortlich, sicherzustellen, dass der richtige Adressraum vor dem Übermitteln eines bestimmten DMA-Puffers wiederhergestellt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Zielplattform- | Arbeitsfläche |
| Header- | d3dkmddi.h |