Поделиться через


функция обратного вызова PDRIVER_IO_PORT_ULONG (video.h)

SvgaHwIoPortUlong перехватывает диапазон портов ввода-вывода, в который полноэкранное приложение MS-DOS на компьютере x86 отправляет последовательность данных размера ULONG.

Синтаксис

PDRIVER_IO_PORT_ULONG PdriverIoPortUlong;

VP_STATUS PdriverIoPortUlong(
  ULONG_PTR Context,
  ULONG Port,
  UCHAR AccessMode,
  PULONG Data
)
{...}

Параметры

Context

Задает определяемое драйвером мини-порта значение контекста, заданное в элементе EmulatorAccessEntriesContext VIDEO_PORT_CONFIG_INFO.

Port

Указывает сопоставленный порт ввода-вывода для перехвата.

AccessMode

Указывает тип разрешенного доступа, который может быть одним или сочетанием (ORed) следующих значений:

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

Указатель на передаваемые данные ULONG.

Возвращаемое значение

SvgaHwIoPortUlong возвращает окончательное состояние операции.

Комментарии

Функции SvgaHwIoPortXxx поддерживают только драйверы минипортов адаптеров SVGA, совместимых с VGA. (См. раздел Функции SVGA.)

SvgaHwIoPortUlong перехватывает любой доступ к диапазону, который пытается получить полноэкранное приложение MS-DOS, выдающее инструкции OUT DX, EAX и IN EAX, DX.

Если драйвер мини-порта включает диапазон портов для прямого доступа путем вызова VideoSetTrappedEmulatorPorts, его функция SvgaHwIoPortUlong вызываться не будет. Такое приложение будет иметь прямой доступ к диапазону портов ввода-вывода, если драйвер мини-порта не отключит этот диапазон с помощью другого вызова VideoSetTrappedEmulatorPorts.

Если одна или несколько инструкций x86 IN или OUT , выданных приложением, могут повлиять на состояние регистра последовательности адаптера, совместимого с VGA, другого выходного регистра или любого регистра адаптера и, таким образом, вызвать зависание компьютера, драйвер мини-порта не должен включать порт для прямого доступа путем вызова VideoPortSetTrappedEmulatorPorts.

SvgaHwIoPortUlong должен буферизать последующие инструкции из приложения и проверка, что никто не может зависнуть на компьютере. Если приложение выдает любую последовательность инструкций, которая может зависнуть на компьютере, SvgaHwIoPortUlong должен отменить буферизацию инструкций. В противном случае он должен выводить их ( ULONG за раз) в указанный сопоставленный порт ввода-вывода.

SvgaHwIoPortUlong следует сделать страничным.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть video.h (включить Video.h)

См. также раздел

EMULATOR_ACCESS_ENTRY

Функции SVGA

SvgaHwIoPortUlongString

VIDEO_ACCESS_RANGE

VIDEO_PORT_CONFIG_INFO

VideoPortGetDeviceBase

VideoPortSetTrappedEmulatorPorts