Freigeben über

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, da das Gerät in einen Fehlerzustand gelangt ist. Ein solcher Fehlerzustand wird in der Regel durch ein Timeout Detection and Recovery (TDR) Ereignis verursacht.

Syntax

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

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

Parameter

hAdapter

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniporttreiber hat dieses Handle zuvor dem DirectX-Grafikkernsubsystem im MiniportDeviceContext Ausgabeparameter des 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 STATUS_SUCCESS nach erfolgreichem Abschluss zurück. Wenn der Treiber stattdessen einen Fehlercode zurückgibt, verursacht das Betriebssystem eine Systemfehlerüberprüfung. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Bemerkungen

Hinweis Das DirectX-Grafik-Kernelsubsystem ruft diese Funktion nur auf, wenn die DXGK_VIDSCHCAPS.CancelCommandAware Member festgelegt ist.
 
Wenn der Treiber einen Fehlercode zurückgibt, verursacht das DirectX-Grafik-Kernelsubsystem eine Systemfehlerüberprüfung. In einer Absturzabbilddatei wird der Fehler durch die Meldung BugCheck-0x119angegeben, die die folgenden vier Parameter enthält.
  1. 0x9
  2. Der vom fehlgeschlagenen Treiberaufruf zurückgegebene NTSTATUS-Fehlercode
  3. Ein Zeiger auf die DXGKARG_CANCELCOMMAND-Struktur
  4. Ein Zeiger auf eine interne Planerdatenstruktur

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 8
mindestens unterstützte Server- Windows Server 2012
Zielplattform- Desktop
Header- d3dkmddi.h
IRQL- PASSIVE_LEVEL

Siehe auch

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice