Condividi tramite


Funzione IddCxReportCriticalError (iddcx.h)

IddCxReportCriticalError è una funzione di callback del sistema operativo chiamata da un driver di visualizzazione indiretto (IDD) per segnalare un errore critico.

Sintassi

NTSTATUS IddCxReportCriticalError(
  IDDCX_ADAPTER                      AdapterObject,
  const IDARG_IN_REPORTCRITICALERROR *pInArgs
);

Parametri

AdapterObject

Oggetto IDDCX_ADAPTER dell'adattatore in cui si è verificato l'errore critico. Se l'errore si è verificato prima della creazione di un IDDCX_ADAPTER, l'IDD deve passare nullptr.

pInArgs

Puntatore a una struttura IDARG_IN_REPORTCRITICALERROR contenente il codice di errore dell'errore critico.

Valore restituito

Se la routine ha esito positivo, non torna mai al driver perché il processo del driver verrà terminato.

Osservazioni

Quando un IDD chiama IddCxCriticalError, il sistema operativo eseguirà le operazioni seguenti:

  • Controllare il driver con il codice di controllo errori seguente: (pInArgs->MajorErrorCode+0x100 << 8) + pInArgs->MinorErrorCode. È consigliabile che il driver usi una combinazione univoca di codice principale e codice secondario, in modo che questi casi possano essere identificati in arresti anomali e report Watson.
  • Terminare il processo del driver e riavviare in base ai criteri di riavvio del driver UMDF.
  • Se il chiamante è un IDD remoto, disconnettere la sessione utente.

Quando viene generato un dump della memoria in modalità utente, il driver deve inserire tutte le informazioni di debug utili sullo stack della funzione che ha chiamato IddCxCriticalError.

Fabbisogno

Requisito Valore
client minimo supportato Windows 10
intestazione iddcx.h

Vedere anche

IDARG_IN_REPORTCRITICALERROR