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_REASON_CALLBACK_RECORD
KeRegisterBugCheckReasonCallback