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
緩衝區的指標,其中包含下表決定的類型結構。 在呼叫回呼例程之前,作系統會先填入此結構的某些成員,而其他成員必須由回呼例程填入。 如需詳細資訊,請參閱 撰寫 Bug 檢查回呼例程。
價值 | 數據結構 |
---|---|
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 參數指向之緩衝區的大小,以位元組為單位。
傳回值
沒有
言論
如需如何實作此回呼例程的詳細資訊,請參閱 撰寫 Bug 檢查回呼例程。
如需示範如何將資料寫入損毀傾印檔案的範例程式代碼,請參閱 DMF_CrashDump。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
IRQL | 在 HIGH_LEVEL呼叫。 |
另請參閱
KBUGCHECK_REASON_CALLBACK_RECORD
KeRegisterBugCheckReasonCallback