Condividi tramite


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

Nota Il sottosistema del kernel della grafica DirectX chiama questa funzione solo se il DXGK_VIDSCHCAPS. Il membro CancelCommandAware è impostato.
 
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