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에서 호출되며 페이지 가능한 코드 또는 데이터에 액세스하려고 시도해서는 안됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | video.h(Video.h 포함) |