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을 지정하여 이전에 등록된 콜백의 등록을 취소할 수 있습니다.

자세한 내용은 버그 확인 콜백 대한Video Port Driver 지원을 참조하세요.

요구 사항

참고 항목

HwVidBugcheckCallback