DXGKDDI_CANCELCOMMAND funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

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

Sintassi

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

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

Parametri

hAdapter

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

pCancelCommand

Puntatore a una struttura di 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 un controllo errori del sistema. Per altre informazioni, vedere la sezione Osservazioni seguente.

Osservazioni

Nota il sottosistema kernel della grafica DirectX chiama questa funzione solo se il DXGK_VIDSCHCAPS.è impostato il membro CancelCommandAware.

Se il driver restituisce un codice di errore, il sottosistema kernel della grafica DirectX causa la verifica di un bug di sistema. In un file di dump di arresto anomalo del sistema, l'errore viene indicato dal messaggio BugCheck 0x119, con i quattro parametri seguenti.

0x9
Codice di errore NTSTATUS restituito dalla chiamata al driver non riuscito
Puntatore alla struttura DXGKARG_CANCELCOMMAND
Puntatore a una struttura di dati dell'utilità di pianificazione interna

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Desktop
intestazione	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Vedere anche

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice

Condividi tramite