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 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows Server 2008부터 지원됩니다.
대상 플랫폼	데스크톱
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
IRQL	HIGH_LEVEL 호출합니다.

참고 항목

KBUGCHECK_ADD_PAGES

KBUGCHECK_CALLBACK_REASON

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

KeDeregisterBugCheckReasonCallback

버그 검사 콜백 루틴 작성