VideoPortLogError 함수(video.h)
VideoPortLogError 함수는 I/O 작업 중 미니포트 드라이버가 하드웨어 오류 조건을 감지하면 시스템 이벤트 로그에 오류를 기록합니다.
통사론
VIDEOPORT_API VOID VideoPortLogError(
PVOID HwDeviceExtension,
PVIDEO_REQUEST_PACKET Vrp,
VP_STATUS ErrorCode,
ULONG UniqueId
);
매개 변수
HwDeviceExtension
미니포트 드라이버의 디바이스 확장에 대한 포인터입니다.
Vrp
[선택 사항] 오류와 연결된 경우 VRP(비디오 요청 패킷)를 설명하는 [VIDEO_REQUEST_PACKET] 구조체에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
ErrorCode
하드웨어 오류 유형을 나타내는 미니포트 드라이버 정의 오류 코드를 지정합니다.
UniqueId
오류에 대한 고유 식별자를 지정합니다. 이 값은 동일한 ErrorCode있는 다른 오류와 현재 오류를 구분합니다. 일부 미니포트 드라이버의 경우 오류가 감지된 코드 줄을 식별합니다. 다른 사용자의 경우 하드웨어에서 반환하는 값입니다.
반환 값
없음
발언
미니포트 드라이버는 VideoPortLogError 호출하여 정상 작동 중에 드라이버가 비정상적인 하드웨어 오류가 발생하는 경우 사용자에게 알려야 합니다. 이러한 오류를 시스템 이벤트 로그에 게시하면 전체 하드웨어 오류가 발생하기 전에 사용자가 어댑터를 교체(또는 다시 구성)할 수 있도록 비디오 어댑터가 실패할 수 있음을 사용자에게 경고합니다.
그러나 미니포트 드라이버는 정상 작동 중에 자주 발생하는 "하드웨어 검색 실패"와 같은 로그 오류를 않아야 합니다.
VideoPortLogError 미니포트 드라이버의 HwVidInterrupt 또는 HwVidSynchronizeExecutionCallback 함수에서 호출할 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 |
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | video.h(Video.h 포함) |
| 라이브러리 | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | <= DIRQL |