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

추가 정보

VideoDebugPrint