WdfVerifierKeBugCheck 함수(wdfverifier.h)

[KMDF 및 UMDF에 적용]

WdfVerifierKeBugCheck 함수는 버그 검사를 만듭니다.

통사론

void WdfVerifierKeBugCheck(
  [in] ULONG     BugCheckCode,
  [in] ULONG_PTR BugCheckParameter1,
  [in] ULONG_PTR BugCheckParameter2,
  [in] ULONG_PTR BugCheckParameter3,
  [in] ULONG_PTR BugCheckParameter4
);

매개 변수

[in] BugCheckCode

Bugcodes.h정의된 버그 검사 코드 중 하나입니다.

[in] BugCheckParameter1

이 매개 변수에 대한 자세한 내용은 지정된 버그 확인 코드의 설명을 참조하세요.

[in] BugCheckParameter2

이 매개 변수에 대한 자세한 내용은 지정된 버그 확인 코드의 설명을 참조하세요.

[in] BugCheckParameter3

이 매개 변수에 대한 자세한 내용은 지정된 버그 확인 코드의 설명을 참조하세요.

[in] BugCheckParameter4

이 매개 변수에 대한 자세한 내용은 지정된 버그 확인 코드의 설명을 참조하세요.

반환 값

없음

발언

Kernel-Mode 드라이버 프레임워크(KMDF) 드라이버가 WdfVerifierKeBugCheck호출하는 경우 디버거가 실행되지 않는 한 운영 체제가 중지되고 파란색 화면 표시됩니다. 자세한 내용은 WinDbg 시작 - 커널 모드참조하세요.

User-Mode 드라이버 프레임워크(버전 2.0 이상)가 WdfVerifierKeBugCheck호출하는 경우 프레임워크는 드라이버가 제공하는 매개 변수를 사용하지 않습니다. 이 경우 프레임워크가 연결된 경우 디버거로 중단됩니다. 디버거가 연결되지 않은 경우 프레임워크는 예외를 생성하고 기본 UMDF 예외 처리기는 미니덤프 파일을 만듭니다. 드라이버 호스트 프로세스에서 처리되지 않은 예외에 대한 자세한 내용은 UMDF에서 오류를 보고하는방법을 참조하세요.

드라이버 디버깅에 대한 자세한 내용은 WDF 드라이버디버깅을 참조하세요.

예제

다음 코드 예제에서는 MULTIPLE_IRP_COMPLETE_REQUESTS 버그 확인 코드를 사용하는 버그 검사를 만듭니다.

WdfVerifierKeBugCheck(
                      MULTIPLE_IRP_COMPLETE_REQUESTS,
                      (ULONG_PTR) irp,
                      (ULONG_PTR) srb,
                      0,
                      0
                      );

요구 사항

요구	값
대상 플랫폼	보편적
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
헤더	wdfverifier.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL	모든 수준
DDI 규정 준수 규칙	DriverCreate(kmdf)

참고 항목

WdfVerifierDbgBreakPoint