DXGKDDI_CANCELCOMMAND Rückruffunktion (d3dkmddi.h)

  • Artikel

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