DXGKDDI_CANCELCOMMAND funzione di callback (d3dkmddi.h)

Pulisce le risorse interne associate a un pacchetto DMA (Direct Memory Access) presente nella coda software dell'utilità di pianificazione GPU, ma non ha mai raggiunto la coda hardware perché il dispositivo è andato in uno stato di errore. Questo stato di errore è in genere causato da un evento TDR (Timeout Detection and Recovery).

Sintassi

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

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

Parametri

hAdapter

Handle a un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport visualizzato in precedenza ha fornito questo handle al sottosistema kernel di grafica DirectX nel parametro di output MiniportDeviceContext della funzione DxgkDdiAddDevice .

pCancelCommand

Puntatore a una struttura DXGKARG_CANCELCOMMAND che specifica le risorse da pulire dopo la rimozione di un comando dalla coda hardware.

Valore restituito

Restituisce STATUS_SUCCESS al completamento corretto. Se il driver restituisce invece un codice di errore, il sistema operativo causa la verifica di un bug di sistema. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Commenti

Se il driver restituisce un codice di errore, il sottosistema del kernel grafico DirectX causa l'esecuzione di un bug di sistema. In un file di dump dell'arresto anomalo, l'errore viene notato dal messaggio BugCheck 0x119, con i quattro parametri seguenti.

1. 0x9
2. Codice di errore NTSTATUS restituito dalla chiamata del driver non riuscito
3. Puntatore alla struttura DXGKARG_CANCELCOMMAND
4. Puntatore a una struttura di dati dell'utilità di pianificazione interna

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Desktop
Intestazione	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Vedi anche

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice