KBUGCHECK_REASON_CALLBACK_ROUTINE回呼函式 (wdm.h)

驅動程式實作的回呼函式會在系統發出錯誤檢查時執行。

如需可用回呼類型的相關信息 ，請參閱KBUGCHECK_CALLBACK_REASON 。

語法

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

參數

[in] Reason

型 別KBUGCHECK_CALLBACK_REASON 列舉，指定回呼例程呼叫的原因。

[in] Record

驅動程式註冊此回呼時所提供的 KBUGCHECK_REASON_CALLBACK_RECORD 結構的指標。 如需詳細資訊，請參閱 KeRegisterBugCheckReasonCallback 中的 CallbackRecord 參數描述。

[in, out] ReasonSpecificData

緩衝區的指標，其中包含下表所決定之型別的結構。 在呼叫回呼例程之前，操作系統會先填入此結構的某些成員，而其他成員必須由回呼例程填入。 如需詳細資訊，請參閱 撰寫錯誤檢查回呼例程。

值	資料結構
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

指定 ReasonSpecificData 參數指向之緩衝區的大小，以位元組為單位。

傳回值

無

備註

如需如何實作此回呼例程的詳細資訊，請參閱 撰寫錯誤檢查回呼例程。

如需示範如何將數據寫入損毀傾印檔案的範例程序代碼，請參閱 DMF_CrashDump。

規格需求

需求	值
目標平台	桌面
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
IRQL	在 HIGH_LEVEL呼叫。

另請參閱

KBUGCHECK_ADD_PAGES

KBUGCHECK_CALLBACK_REASON

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

KeDeregisterBugCheckReasonCallback

撰寫錯誤檢查回呼例程。