PDRIVER_IO_PORT_UCHAR 콜백 함수(video.h)

아티클
02/07/2025

SvgaHwIoPortUchar x86 기반 컴퓨터의 전체 화면 MS-DOS 애플리케이션이 UCHAR 크기의 데이터를 보내는 I/O 포트를 트래핑합니다.

통사론

PDRIVER_IO_PORT_UCHAR PdriverIoPortUchar;

VP_STATUS PdriverIoPortUchar(
  ULONG_PTR Context,
  ULONG Port,
  UCHAR AccessMode,
  PUCHAR Data
)
{...}

매개 변수

Context

VIDEO_PORT_CONFIG_INFOEmulatorAccessEntriesContext 멤버에 설정된 미니포트 드라이버 정의 컨텍스트 값을 지정합니다.

Port

트래핑할 매핑된 I/O 포트를 지정합니다.

AccessMode

트래핑할 액세스 유형을 지정합니다. 이 형식은 다음 값 중 하나 또는 조합(ORed)일 수 있습니다.

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

전송할 바이트에 대한 포인터입니다.

반환 값

SvgaHwIoPortUchar 작업의 최종 상태를 반환합니다.

발언

VGA 호환 SVGA 어댑터의 미니포트 드라이버만 SvgaHwIoPortXxx 함수가 있습니다. (SVGA 함수참조하세요.)

SvgaHwIoPortUchar OUT DX, AL 및 IN AL, DX 전체 화면 MS-DOS 애플리케이션에서 시도한 바이트 액세스를 모두 가로채는 것입니다.

미니포트 드라이버가 VideoPortSetTrappedEmulatorPorts호출하여 포트 직접 액세스할 수 있도록 하는 경우 SvgaHwIoPortUchar 함수가 호출되지 않습니다. 미니포트 드라이버가 VideoPortSetTrappedEmulatorPorts대한 다른 호출로 포트 사용하지 않도록 설정하지 않는 한 이러한 애플리케이션은 포트직접 액세스할 수 있습니다.

하나 이상의 애플리케이션 발급 x86 IN 또는 OUT 지침이 VGA 호환 어댑터 시퀀서 레지스터의 상태에 영향을 줄 수 있습니다. 기타 출력 레지스터 또는 어댑터별 레지스터 및 이로 인해 컴퓨터가 중단되면 미니포트 드라이버는 VideoPortSetTrappedEmulatorPorts를 호출하여 직접 액세스하기 위해 포트를 사용하도록 설정하지 합니다.

SvgaHwIoPortUchar 애플리케이션에서 포트 후속 지침을 버퍼링하고 컴퓨터를 중단할 수 없는지 확인해야 합니다. 애플리케이션이 머신을 중단할 수 있는 명령 시퀀스를 발급하는 경우 SvgaHwIoPortUchar 버퍼링된 지침을 삭제해야 합니다. 그렇지 않으면 지정된 매핑된 I/O 포트에 UCHAR를 한 번에 출력해야 합니다.

SvgaHwIoPortUchar 페이지 가능해야 합니다.