Funzione KeRegisterBugCheckReasonCallback (wdm.h)

Articolo
02/29/2024

La funzione KeRegisterBugCheckReasonCallback registra una routine di callback eseguita quando il sistema operativo rilascia un controllo di bug.

Sintassi

BOOLEAN KeRegisterBugCheckReasonCallback(
  [out] PKBUGCHECK_REASON_CALLBACK_RECORD  CallbackRecord,
  [in]  PKBUGCHECK_REASON_CALLBACK_ROUTINE CallbackRoutine,
  [in]  KBUGCHECK_CALLBACK_REASON          Reason,
  [in]  PUCHAR                             Component
);

Parametri

[out] CallbackRecord

Puntatore a una struttura KBUGCHECK_REASON_CALLBACK_RECORD inizializzata da una chiamata alla routine KeInitializeCallbackRecord descritta nelle macro del kernel di Windows.

[in] CallbackRoutine

Puntatore a una routine di callback di tipo KBUGCHECK_REASON_CALLBACK_ROUTINE da registrare. Per informazioni su come implementare questa routine di callback, vedere Scrittura di una routine di callback di controllo di bug.

[in] Reason

Enumerazione di tipo KBUGCHECK_CALLBACK_REASON che specifica il tipo di routine di callback a cui punta CallbackRoutine .

[in] Component

Puntatore a una stringa ANSI con terminazione Null che identifica il chiamante. Ad esempio, è possibile selezionare una stringa che descrive il driver di dispositivo o che contiene il nome del dispositivo. È possibile usare l'estensione del debugger !bugdump per visualizzare i dati del dump di arresto anomalo del sistema associati a questa stringa.

Valore restituito

KeRegisterBugCheckReasonCallback restituisce TRUE se la routine di callback è stata registrata correttamente; in caso contrario, restituisce FALSE.

Commenti

I driver possono usare KeRegisterBugCheckReasonCallback per registrare routine eseguite durante un controllo dei bug di sistema.

Per le descrizioni di ogni tipo di callback, vedere KBUGCHECK_CALLBACK_REASON.

I driver possono usare la routine KeDeregisterBugCheckReasonCallback per rimuovere la registrazione del callback di controllo bug. Qualsiasi driver che può essere scaricato deve rimuovere le registrazioni di tutti i callback nella routine Scarica .

Per informazioni su come implementare queste routine di callback, vedere Scrittura di una routine di callback di controllo di bug.

Per visualizzare i dati di dump secondari, è possibile usare il metodo IDebugDataSpaces3::ReadTagged** in un'estensione del debugger. Un'altra opzione consiste nel eseguire il debug della routine di callback di controllo dei bug stessa. Per altre informazioni sui debugger e sulle estensioni del debugger, vedere Debug di Windows.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows XP Service Pack 1 (SP1), Windows Server 2003 e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Qualsiasi livello