Función KeRegisterBugCheckReasonCallback (wdm.h)

Artículo
02/07/2025

La función KeRegisterBugCheckReasonCallback registra una rutina de devolución de llamada que se ejecuta cuando el sistema operativo emite una comprobación de errores.

Sintaxis

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

Parámetros

[out] CallbackRecord

Puntero a una estructura de KBUGCHECK_REASON_CALLBACK_RECORD inicializada por una llamada a la rutina KeInitializeCallbackRecord descrita en las macros de kernel de Windows .

[in] CallbackRoutine

Puntero a una rutina de devolución de llamada de tipo KBUGCHECK_REASON_CALLBACK_ROUTINE registrar. Para obtener información sobre cómo implementar esta rutina de devolución de llamada, consulte Escribir una rutina de devolución de llamada de comprobación de errores.

[in] Reason

Enumeración de tipo KBUGCHECK_CALLBACK_REASON que especifica el tipo de rutina de devolución de llamada a la que apunta CallbackRoutine.

[in] Component

Puntero a una cadena ANSI terminada en null que identifica al autor de la llamada. Por ejemplo, puede seleccionar una cadena que describa el controlador de dispositivo o que contenga el nombre del dispositivo. Puede usar la extensión del depurador de !bugdump para mostrar los datos de volcado de memoria asociados a esta cadena.

Valor devuelto

KeRegisterBugCheckReasonCallback devuelve TRUE si la rutina de devolución de llamada se registra correctamente; de lo contrario, devuelve FALSE.

Observaciones

Los controladores pueden usar keRegisterBugCheckReasonCallback para registrar rutinas que se ejecutan durante una comprobación de errores del sistema.

Para obtener descripciones de cada tipo de devolución de llamada, consulte KBUGCHECK_CALLBACK_REASON.

Los controladores pueden usar la rutinaKeDeregisterBugCheckReasonCallback para quitar el registro de devolución de llamada de comprobación de errores. Cualquier controlador que se pueda descargar debe quitar los registros de todas sus devoluciones de llamada en su rutina Descargar.

Para obtener información sobre cómo implementar estas rutinas de devolución de llamada, consulte Escribir una rutina de devolución de llamada de comprobación de errores.

Para mostrar los datos de volcado de memoria secundarios, puede usar el método IDebugDataSpaces3::ReadTagged** en una extensión del depurador. Otra opción es depurar la rutina de devolución de llamada de comprobación de errores. Para obtener más información sobre los depuradores y las extensiones del depurador, consulte Depuración de Windows.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows XP Service Pack 1 (SP1), Windows Server 2003 y versiones posteriores de Windows.
de la plataforma de destino de	Universal
encabezado de	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	Cualquier nivel