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, dass der richtige Adressraum wiederhergestellt wird, bevor ein bestimmter DMA-Puffer übermittelt wird.
Syntax
DXGKDDI_SUBMITCOMMANDVIRTUAL DxgkddiSubmitcommandvirtual;
NTSTATUS DxgkddiSubmitcommandvirtual(
IN_CONST_HANDLE hAdapter,
IN_CONST_PDXGKARG_SUBMITCOMMANDVIRTUAL pSubmitCommand
)
{...}
Parameter
hAdapter
Ein Handle für einen 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 | Es wird festgestellt, dass die DMA- oder privaten Daten fehlerhaft sind. In diesem Fall versetzt das Betriebssystem das aufrufende Gerät in einen Fehlerzustand, und alle nachfolgenden Aufrufe schlagen fehl. Der an diesen Aufruf übergebene SubmissionFenceId-Wert gilt als abgeschlossen, nachdem alle vorherigen Pakete auf der Hardware abgeschlossen sind, und zu diesem Zeitpunkt sollte die Treiberidee der letzten abgeschlossenen Zaun-ID auf diesen Wert aktualisiert werden. Hinweis: Dieses Verhalten unterscheidet sich vom DxgkDdiSubmitCommand-Aufruf , bei dem kein Fehler zurückgegeben werden darf, da die Daten in einem vorherigen DxgkDdiRender-Aufruf überprüft werden können. |
Alle anderen Rückgabewerte führen zur Fehlerüberprüfung des Betriebssystems.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Zielplattform | Desktop |
| Kopfzeile | d3dkmddi.h |