共用方式為


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

撰寫錯誤檢查回呼例程