PVIDEO_BUGCHECK_CALLBACK 콜백 함수(video.h)

HwVidBugcheckCallback 함수를 사용하면 버그 검사 발생할 때 미니포트 드라이버가 덤프 파일에 데이터를 추가할 수 있습니다.

구문

PVIDEO_BUGCHECK_CALLBACK PvideoBugcheckCallback;

void PvideoBugcheckCallback(
  [in] IN PVOID HwDeviceExtension,
  [in] IN ULONG BugcheckCode,
  [in] IN PUCHAR Buffer,
  [in] IN ULONG BufferSize
)
{...}

매개 변수

[in] HwDeviceExtension

미니포트 드라이버의 어댑터별 스토리지 영역에 대한 포인터입니다. 자세한 내용은 디바이스 확장을 참조하세요.

[in] BugcheckCode

버그 검사 코드를 지정합니다.

[in] Buffer

미니포트 드라이버가 덤프 파일에 추가할 데이터를 저장할 수 있는 메모리 위치에 대한 포인터입니다.

[in] BufferSize

Buffer 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정합니다.

반환 값

없음

설명

이 함수는 Windows XP SP1 이상에서 사용할 수 있습니다.

이 함수는 버그 검사 발생할 때 호출됩니다. 미니포트 드라이버는 덤프 파일에 추가할 데이터를 수집하고 이 데이터를 버퍼에 쓸 수 있습니다. 드라이버는 버퍼에 BufferSize 바이트 이상을 작성해서는 안 됩니다.

비디오 미니포트 드라이버는 VideoPortRegisterBugcheckCallback 함수를 호출하여 HwVidBugcheckCallback 함수를 등록합니다. VideoPortRegisterBugcheckCallback 함수는 이 비디오 미니포트 드라이버 제공 콜백을 시스템에 노출합니다.

버그 검사 후 시스템 복구를 용이하게 하기 위해 이 함수에서 액세스하는 모든 레지스터는 디바이스 상태에 관계없이 하드웨어가 대체 모드로 전송하는 기능을 방해해서는 안 됩니다. 또한 함수는 해당 호출자에게 컨트롤을 반환 해야 합니다 .

시스템은 여러 비디오 미니포트 드라이버로 구성되므로 공급업체는 이 함수가 덤프 파일에 추가하는 데이터에 식별 문자열을 추가해야 합니다.

함수는 발생된 IRQL에서 호출되며 페이지 가능한 코드 또는 데이터에 액세스하려고 시도해서는 안됩니다.

요구 사항

추가 정보

VideoPortRegisterBugcheckCallback