Función KeRegisterBugCheckReasonCallback (wdm.h)

Artículo
03/08/2023

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 que se inicializó mediante una llamada a la rutina KeInitializeCallbackRecord descrita en las macros del kernel de Windows.

[in] CallbackRoutine

Puntero a una rutina de devolución de llamada de tipo KBUGCHECK_REASON_CALLBACK_ROUTINE que se va a registrar. Para obtener información sobre cómo implementar esta rutina de devolución de llamada, vea 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 !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.

Comentarios

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 rutina KeDeregisterBugCheckReasonCallback 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 Unload .

Para obtener información sobre cómo implementar estas rutinas de devolución de llamada, vea 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, vea Depuración de Windows.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows XP Service Pack 1 (SP1), Windows Server 2003 y versiones posteriores de Windows.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	Cualquier nivel