共用方式為


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_ADD_PAGES

KBUGCHECK_CALLBACK_REASON

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

KeDeregisterBugCheckReasonCallback

撰寫錯誤檢查回呼例程