DXGKDDI_SUBMITCOMMANDVIRTUAL Rückruffunktion (d3dkmddi.h)
DxgkDdiSubmitCommandVirtual wird verwendet, um einen DMA-Puffer (Direct Memory Access) an einen Kontext zu übermitteln, der die virtuelle Adressierung unterstützt.
Der Treiber ist dafür verantwortlich, sicherzustellen, dass der richtige Adressraum vor dem Übermitteln eines bestimmten DMA-Puffers wiederhergestellt wird.
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.
pSubmitCommand
Ein Zeiger auf eine DXGKARG_SUBMITCOMMANDVIRTUAL Struktur, die den Vorgang beschreibt.
Rückgabewert
| Wert | Beschreibung |
|---|---|
| STATUS_SUCCESS | 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. Hinweis: Dieses Verhalten unterscheidet sich von DxgkDdiSubmitCommand Aufruf, bei dem kein Fehler zurückgegeben werden darf, da die Möglichkeit besteht, die Daten in einem vorherigen DxgkDdiRender Aufruf zu überprüfen. |
Alle anderen Rückgabewerte führen zu Fehlerüberprüfung des Betriebssystems.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h |