VideoPortRegisterBugcheckCallback 함수(video.h)

  • 아티클

VideoPortRegisterBugcheckCallback 함수를 사용하면 비디오 미니포트 드라이버가 지정된 버그 검사 발생할 때 호출되는 콜백을 등록하거나 후크할 수 있습니다.

구문

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortRegisterBugcheckCallback(
  [in] IN PVOID                    HwDeviceExtension,
  [in] IN ULONG                    BugcheckCode,
  [in] IN PVIDEO_BUGCHECK_CALLBACK Callback,
  [in] IN ULONG                    BugcheckDataSize
);

매개 변수

[in] HwDeviceExtension

미니포트 드라이버의 디바이스 확장에 대한 포인터입니다.

[in] BugcheckCode

다시 호출할 버그 검사 코드를 나타냅니다. 현재 미니포트 드라이버는 버그 검사 코드 0xEA 등록할 수 있습니다.

[in] Callback

미니포트 드라이버의 HwVidBugcheckCallback 함수에 대한 포인터입니다. 이 함수는 페이지가 지정되지 않아야 하며 페이징 가능한 코드 또는 데이터를 참조해서는 안 됩니다. 미니포트 드라이버는 이 매개 변수를 NULL로 설정하여 버그 검사 콜백을 해제해야 함을 나타낼 수 있습니다.

[in] BugcheckDataSize

BUGCHECK_DATA_SIZE_RESERVED 합계와 미니포트 드라이버가 덤프 파일에 포함하기 위해 제공할 데이터 바이트 수를 나타냅니다. 이 매개 변수의 값은 4000보다 작거나 같아야 합니다. 미니포트 드라이버는 이 매개 변수를 0으로 설정하여 버그 검사 콜백을 해제해야 함을 나타낼 수 있습니다.

반환 값

VideoPortRegisterBugcheckCallback 은 성공하면 NO_ERROR 반환합니다. 그렇지 않으면 실패의 특성을 나타내는 상태 코드를 반환합니다.

설명

Windows XP 또는 이전 NT 기본 운영 체제에서 실행하려는 비디오 미니포트 드라이버를 개발하는 경우 VideoPortGetProcAddress 콜백 루틴을 사용하여 VideoPortRegisterBugcheckCallback 함수의 주소를 찾을 수 있습니다. 자세한 내용은 VideoPortGetProcAddress 사용을 참조하세요.

미니포트 드라이버는 특정 유형의 버그 검사 발생할 때 콜백에 등록할 수 있습니다. 현재 버그 검사 코드 0xEA 후크할 수 있습니다. 버그 검사 발생하면 미니드라이버 제공 콜백 함수가 호출되고 미니포트 드라이버가 데이터를 덤프 파일에 추가할 수 있습니다. 이는 직접 디버깅이 불가능한 경우 통계 데이터를 수집하는 데 유용합니다.

BugcheckDataSize 매개 변수의 값은 미니포트 드라이버에서 제공하는 데이터보다 BUGCHECK_DATA_SIZE_RESERVED 바이트여야 합니다. 예를 들어 미니포트 드라이버가 덤프 파일에 쓸 데이터의 DUMP_SIZE 바이트를 제공한다고 가정해 보겠습니다. 그런 다음 BugcheckDataSize 값은 DUMP_SIZE + BUGCHECK_DATA_SIZE_RESERVED, 총 값은 4000보다 작거나 같아야 합니다.

상수 BUGCHECK_DATA_SIZE_RESERVED( video.h에 정의됨)은 Microsoft Windows Server 2003 이상 빌드 환경에서 사용할 수 있습니다. Windows XP SP1 빌드 환경에서는 BUGCHECK_DATA_SIZE_RESERVED 대신 48을 사용합니다.

미니포트 드라이버는 이 함수를 호출하고 콜백 매개 변수에 NULL을 지정하거나 DataSize 매개 변수에 대해 0을 지정하여 이전에 등록된 콜백의 등록을 취소할 수 있습니다.

자세한 내용은 버그 검사 콜백에 대한 비디오 포트 드라이버 지원을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP SP1 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 video.h(Video.h 포함)
라이브러리 Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

추가 정보

HwVidBugcheckCallback