DXGKDDI_CANCELCOMMAND Rückruffunktion (d3dkmddi.h)

Bereinigt interne Ressourcen, die einem DMA-Paket (Direct Memory Access) zugeordnet sind, das sich in der Softwarewarteschlange des GPU-Schedulers befand, aber nie die Hardwarewarteschlange erreicht hat, weil das Gerät in einen Fehlerzustand versetzt wurde. Ein solcher Fehlerzustand wird in der Regel durch ein Timeouterkennungs- und Wiederherstellungsereignis (Timeout Detection and Recovery, TDR) verursacht.

Syntax

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

NTSTATUS DxgkddiCancelcommand(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_CANCELCOMMAND pCancelCommand
)
{...}

Parameter

hAdapter

Ein Handle für einen Kontextblock, der einer Grafikkarte zugeordnet ist. Der Anzeige-Miniporttreiber hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem im Ausgabeparameter MiniportDeviceContext der DxgkDdiAddDevice-Funktion bereitgestellt.

pCancelCommand

Ein Zeiger auf eine DXGKARG_CANCELCOMMAND-Struktur , die Ressourcen angibt, die bereinigt werden sollen, nachdem ein Befehl aus der Hardwarewarteschlange entfernt wurde.

Rückgabewert

Gibt nach erfolgreichem Abschluss STATUS_SUCCESS zurück. Wenn der Treiber stattdessen einen Fehlercode zurückgibt, verursacht das Betriebssystem eine Systemfehlerprüfung. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Hinweise

Hinweis Das DirectX-Grafikkernsubsystem ruft diese Funktion nur auf, wenn die DXGK_VIDSCHCAPS. CancelCommandAware-Member ist festgelegt.

 

Wenn der Treiber einen Fehlercode zurückgibt, führt das DirectX-Grafikkernsystem zu einer Systemfehlerüberprüfung. In einer Absturzabbilddatei wird der Fehler durch die Meldung BugCheck 0x119 mit den folgenden vier Parametern notiert.

1. 0x9
2. Der NTSTATUS-Fehlercode, der vom fehlerhaften Treiberaufruf zurückgegeben wurde
3. Ein Zeiger auf die DXGKARG_CANCELCOMMAND-Struktur
4. Ein Zeiger auf eine interne Planerdatenstruktur

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Weitere Informationen

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice