Funzione IddCxReportCriticalError (iddcx.h)

  • Articolo

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 si è verificato l'errore 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 restituisce mai al driver perché il processo del driver verrà terminato.

Commenti

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

  • Controllare il driver con il codice di controllo bug 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 negli arresti anomali e nei report di 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 di memoria in modalità utente, il driver deve inserire eventuali informazioni di debug utili sullo stack della funzione che ha chiamato IddCxCriticalError.

Requisiti

Requisito Valore
Client minimo supportato Windows 10
Intestazione iddcx.h

Vedi anche

IDARG_IN_REPORTCRITICALERROR