DXGKDDI_SUBMITCOMMAND Rückruffunktion (d3dkmddi.h)
Die DxgkDdiSubmitCommand-Funktion sendet einen DMA-Puffer (Direct Memory Access) an die Hardwarebefehlsausführungseinheit.
Syntax
DXGKDDI_SUBMITCOMMAND DxgkddiSubmitcommand;
NTSTATUS DxgkddiSubmitcommand(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_SUBMITCOMMAND pSubmitCommand
)
{...}
Parameter
[in] hAdapter
Ein Handle für einen Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Anzeigeminiporttreiber hat dieses Handle zuvor für das Microsoft DirectX-Grafikkernsubsystem im Ausgabeparameter MiniportDeviceContext der DxgkDdiAddDevice-Funktion bereitgestellt.
[in] pSubmitCommand
Ein Zeiger auf eine DXGKARG_SUBMITCOMMAND-Struktur , die den DMA-Puffer beschreibt, den der Anzeigeminiporttreiber an die Hardwarebefehlsausführungseinheit übermittelt.
Rückgabewert
DxgkDdiSubmitCommand gibt nach erfolgreichem Abschluss STATUS_SUCCESS zurück. Wenn der Treiber stattdessen einen Fehlercode zurückgibt, führt das Betriebssystem zu einer Systemfehlerüberprüfung. Siehe Hinweise.
Hinweise
Da Pagingvorgänge als Systemvorgänge betrachtet werden, sind sie keinem bestimmten Anwendungskontext oder Grafikkontext zugeordnet. Wenn die Übermittlung für einen Pagingvorgang gilt, wird daher die DxgkDdiSubmitCommand-Funktion mit NULL aufgerufen, die im hDevice-Element der DXGKARG_SUBMITCOMMAND-Struktur angegeben ist, auf die der pSubmitCommand-Parameter verweist.
Wenn die Architektur einer bestimmten Hardware und eines bestimmten Treibers jedoch intern über ein Gerät verfügen muss, muss der Treiber das Gerät während der Adapterinitialisierung intern erstellen und das Gerät intern als Systemstandardgerät für die Verwendung in Pagingvorgängen beibehalten.
Der Treiber kann den Wert, der im SubmissionFenceId-Member von DXGKARG_SUBMITCOMMAND angegeben wird, in den Fence-Befehl im Ringpuffer schreiben. Weitere Informationen zu Zaunbefehlen finden Sie unter Bereitstellen von Zaunbezeichnern.
Wenn der Treiber einen Fehlercode zurückgibt, verursacht das DirectX-Grafikkernsubsystem eine Systemfehlerüberprüfung. In einer Absturzabbilddatei wird der Fehler durch die Meldung BugCheck 0x119 notiert, die die folgenden vier Parameter aufweist.
- 0x2 (identifiziert die Fehlerursache)
- Der NTSTATUS-Fehlercode, der vom fehlerhaften Treiberaufruf zurückgegeben wurde
- Ein Zeiger auf die DXGKARG_SUBMITCOMMAND-Struktur
- Ein Zeiger auf eine interne Planerdatenstruktur
DxgkDdiSubmitCommand sollte nicht ausstellbar sein, da es mit IRQL = DISPATCH_LEVEL ausgeführt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |