KBUGCHECK_REASON_CALLBACK_ROUTINE función de devolución de llamada (wdm.h)

  • Artículo

Funciones de devolución de llamada implementadas por el controlador que el sistema ejecuta cuando emite una comprobación de errores.

Consulte KBUGCHECK_CALLBACK_REASON para obtener información sobre los tipos de devolución de llamada disponibles.

Sintaxis

KBUGCHECK_REASON_CALLBACK_ROUTINE KbugcheckReasonCallbackRoutine;

void KbugcheckReasonCallbackRoutine(
  [in]      KBUGCHECK_CALLBACK_REASON Reason,
  [in]      _KBUGCHECK_REASON_CALLBACK_RECORD *Record,
  [in, out] PVOID ReasonSpecificData,
  [in]      ULONG ReasonSpecificDataLength
)
{...}

Parámetros

[in] Reason

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

[in] Record

Puntero a la estructura KBUGCHECK_REASON_CALLBACK_RECORD que el controlador proporcionó cuando registró esta devolución de llamada. Para obtener más información, vea la descripción del parámetro CallbackRecord en KeRegisterBugCheckReasonCallback.

[in, out] ReasonSpecificData

Puntero a un búfer que contiene una estructura de tipo determinada por la tabla siguiente. El sistema operativo rellena algunos miembros de esta estructura antes de llamar a la rutina de devolución de llamada y otros miembros deben rellenarse con la rutina de devolución de llamada. Para obtener más información, vea Escribir una rutina de devolución de llamada de comprobación de errores.

Valor Estructura de los datos
KbCallbackSecondaryDumpData KBUGCHECK_SECONDARY_DUMP_DATA
KbCallbackDumpIo KBUGCHECK_DUMP_IO
KbCallbackAddPages KBUGCHECK_ADD_PAGES
KbCallbackSecondaryMultiPartDumpData KBUGCHECK_SECONDARY_DUMP_DATA_EX
KbCallbackRemovePages KBUGCHECK_REMOVE_PAGES
KbCallbackTriageDumpData KBUGCHECK_TRIAGE_DUMP_DATA

[in] ReasonSpecificDataLength

Especifica el tamaño, en bytes, del búfer al que apunta el parámetro ReasonSpecificData .

Valor devuelto

None

Observaciones

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.

Para obtener código de ejemplo que muestra cómo escribir datos en el archivo de volcado de memoria, consulte DMF_CrashDump.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
IRQL Se llama en HIGH_LEVEL.

Consulte también

KBUGCHECK_ADD_PAGES

KBUGCHECK_CALLBACK_REASON

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

KeDeregisterBugCheckReasonCallback

Escribir una rutina de devolución de llamada de comprobación de errores.