Condividi tramite

KBUGCHECK_REASON_CALLBACK_ROUTINE funzione di callback (wdm.h)

  • Articolo

Funzioni di callback implementate dal driver eseguite dal sistema quando genera un controllo di bug.

Per informazioni sui tipi di callback disponibili, vedere KBUGCHECK_CALLBACK_REASON .

Sintassi

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
)
{...}

Parametri

[in] Reason

Enumerazione di tipo KBUGCHECK_CALLBACK_REASON che specifica il motivo della chiamata alla routine di callback.

[in] Record

Puntatore alla struttura KBUGCHECK_REASON_CALLBACK_RECORD fornita dal driver quando ha registrato questo callback. Per altre informazioni, vedere la descrizione del parametro CallbackRecord in KeRegisterBugCheckReasonCallback.

[in, out] ReasonSpecificData

Puntatore a un buffer contenente una struttura di tipo determinata dalla tabella seguente. Alcuni membri di questa struttura vengono compilati dal sistema operativo prima di chiamare la routine di callback e altri membri devono essere compilati dalla routine di callback. Per altre informazioni, vedere Scrittura di una routine di controllo bug.

Valore Struttura dei dati
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

Specifica le dimensioni, in byte, del buffer a cui punta il parametro ReasonSpecificData .

Valore restituito

nessuno

Osservazioni

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

Per codice di esempio che illustra come scrivere dati nel file di dump di arresto anomalo, vedere DMF_CrashDump.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL Chiamato in HIGH_LEVEL.

Vedi anche

KBUGCHECK_ADD_PAGES

KBUGCHECK_CALLBACK_REASON

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

KeDeregisterBugCheckReasonCallback

Scrittura di una routine di controllo bug.