PVIDEO_HW_RESET_HW 콜백 함수(video.h)

아티클
02/29/2024

HwVidResetHw 는 어댑터를 문자 모드로 다시 설정합니다.

구문

PVIDEO_HW_RESET_HW PvideoHwResetHw;

BOOLEAN PvideoHwResetHw(
  PVOID HwDeviceExtension,
  ULONG Columns,
  ULONG Rows
)
{...}

매개 변수

HwDeviceExtension

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

Columns

설정할 모드의 열 수를 지정합니다.

Rows

설정할 모드의 행 수를 지정합니다.

반환 값

어댑터를 지정된 문자 모드로 완전히 다시 설정하는 경우 HwVidResetHw는 TRUE를 반환해야 합니다. 그렇지 않으면 HwVidResetHw가 컨트롤을 반환한 후 HAL이 INT10, MODE3 형식 BIOS 호출과 동등한 작업을 수행해야 함을 나타내려면 FALSE를 반환해야 합니다.

설명

컴퓨터의 하드 부팅 없이 어댑터를 완전히 초기화된 상태로 다시 설정할 수 없는 경우 비디오 미니포트 드라이버에는 HwVidResetHw 함수가 있어야 합니다. 예를 들어 어댑터의 ROM 초기화 코드가 어댑터 상태를 부팅 모드로 다시 설정할 수 없는 경우 미니포트 드라이버에는 HwVidResetHw 함수가 있어야 합니다. 미니포트 드라이버가 이 기능을 구현해야 하는 또 다른 이유는 어댑터가 전원이 끊어질 때 어댑터의 인터럽트 라인을 클린 다음 번에 시스템이 부팅될 때 인터럽트의 홍수를 피하기 위해서입니다.

시스템이 작동 중단될 경우 HAL은 HwVidResetHw 를 호출하므로 시스템이 종료되는 동안 HAL이 화면에 정보를 표시할 수 있습니다. 이 호출은 모든 IRQL에서 발생할 수 있으며 드라이버는 언제든지 처리할 준비가 되어 있어야 합니다. HAL은 또한 소프트 부팅이 발생할 때 컴퓨터를 다시 부팅하기 직전에 HwVidResetHw 를 호출합니다.

대부분의 미니포트 드라이버는 INT10, MODE3 형식 명령을 수신할 때 VGA 표준 문자 모드로 다시 설정되는 어댑터 드라이버를 제외하고 이 기능을 제공해야 합니다.

HwVidResetHw 는 지정된 열 및 행 값에 따라 어댑터를 문자 모드로 다시 설정합니다. 그러나 시스템이 종료되므로 HwVidResetHw 는 BIOS 또는 페이징 가능한 코드를 호출할 수 없습니다. HwVidResetHw 는 VideoPortRead/WritePortXxx 및/또는 VideoPortRead/WriteRegisterXxx 함수만 호출해야 합니다. ( 비디오 포트 드라이버에서 내보낸 함수를 참조하세요.)

HwVidResetHw가 어댑터 레지스터를 프로그래밍하여 어댑터 모드를 변경할 수 없는 경우 어댑터 레지스터에 적절한 값을 설정하고 FALSE를 반환할 수 있습니다. 이로 인해 HAL이 확장된 INT10 형식 작업을 수행하여 비디오 어댑터를 문자 모드로 다시 설정합니다.

HwVidResetHw 는 VideoPortInt10을 호출해서는 안 됩니다. 미니포트 드라이버의 HwVidStartIO 함수는 디스플레이 프로그램이 미니포트 드라이버의 HwVidResetHw 함수가 아닌 그래픽 디스플레이 모드를 테스트하거나 변경하는 데 사용될 때마다 어댑터를 다시 설정하기 위해 IOCTL_VIDEO_RESET_DEVICE VRP와 함께 호출됩니다.

HwVidResetHw 는 페이징 가능으로 만들어서는 안 됩니다.