Функция VideoPortSetTrappedEmulatorPorts (video.h)

Статья
08/08/2023

Драйверы мини-портов, совместимые с VGA (SVGA), вызывают функцию VideoPortSetTrappedEmulatorPorts , чтобы динамически изменять список портов ввода-вывода, которые перехватываются при выполнении видеоэкранного монитора VDM в полноэкранном режиме на компьютере с архитектурой x86.

Синтаксис

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortSetTrappedEmulatorPorts(
       PVOID               HwDeviceExtension,
       ULONG               NumAccessRanges,
  [in] PVIDEO_ACCESS_RANGE AccessRange
);

Параметры

HwDeviceExtension

Указатель на расширение устройства драйвера мини-порта.

NumAccessRanges

Указывает количество элементов в массиве AccessRange .

[in] AccessRange

Указатель на массив элементов VIDEO_ACCESS_RANGE . Каждый элемент описывает правильный поддиаг emulatorAccessEntries , настроенный драйвером мини-порта в VIDEO_PORT_CONFIG_INFO. Задание для элемента RangeVisible элемента AccessRangeзначения TRUE обеспечивает прямой доступ к диапазону портов ввода-вывода полноэкранным приложением MS-DOS. Задание для элемента RangeVisibleзначения FALSE приводит к тому, что выданные приложением значения INs, INSB/INSW/INSDs, OUTs и (или ) OUTSB/OUTSB/OUTSDs будут захвачены в этот диапазон и перенаправляются в соответствующий драйвер miniport SvgaHwIoPortXxx для проверки.

Массив AccessRange, передаваемый в VideoPortSetTrappedEmulatorPorts , должен быть соответствующим подмножеством диапазонов портов ввода-вывода, настроенных функцией HwVidFindAdapter в массиве EmulatorAccessEntriesструктуры VIDEO_PORT_CONFIG_INFO . Все диапазоны портов ввода-вывода в массиве диапазонов доступа, которые не включены в массив EmulatorAccessEntries , перехватываются и отражаются на VDD пользовательского режима.

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

VideoPortSetTrappedEmulatorPorts возвращает NO_ERROR, если он успешно изменил захваченные порты. В противном случае возвращается ERROR_INVALID_PARAMETER.

По умолчанию accessRange портов ввода-вывода, к которым могут обращаться полноэкранные приложения MS-DOS, напрямую не включает ни один из элементов массива диапазонов доступа, описывающих диапазоны портов ввода-вывода, которые также имеют соответствующие элементы в массиве EmulatorAccessEntriesструктуры VIDEO_PORT_CONFIG_INFO . То есть диапазоны портов ввода-вывода с соответствующими записями доступа эмулятора по умолчанию подключены к функциям SvgaHwIoPortXxx драйвера мини-порта, поэтому выданные приложением инструкции перенаправляются в функции SvgaHwIoPortXxx для проверки.

Совместимый с VGA драйвер svga miniport может включать и отключать диапазоны портов ввода-вывода по мере необходимости с помощью вызовов VideoPortSetTrappedEmulatorPorts. Включенные диапазоны портов позволяют полноэкранному приложению MS-DOS напрямую обращаться к этим портам ввода-вывода без предварительной проверки инструкций сборки, выданных приложением, и перенаправляемых в функции SvgaHwIoPortXxxx . Прямой доступ к порту ввода-вывода для такого приложения позволяет пользователю быстрее реагировать на видео.

VideoPortSetTrappedEmulatorPorts сканирует массив параметров AccessRange от первого элемента до последнего, включая и отключая порты ввода-вывода, как указано в каждом элементе. Обратите внимание, что диапазон включенных портов (элемент RangeVisible имеет значение TRUE) можно снова отключить в том же вызове, если драйвер мини-порта содержит повторяющееся описание того же диапазона с элементом RangeVisible, равнымFALSE. Обратите внимание также, что драйвер минипорта может включить широкий спектр портов ввода-вывода в исходном элементе массива AccessRange и выборочно отключить поддиапозоны портов в последующих элементах массива при вызове VideoPortSetTrappedEmulatorPorts.

Все полноэкранные приложения MS-DOS используют одно и то же ioPM (сопоставление разрешений ввода-вывода) на компьютерах с архитектурой x86 и, следовательно, тот же набор включенных или отключенных портов ввода-вывода. При каждом переходе на такое полноэкранное приложение функция HwVidStartIO драйвера мини-порта, совместимая с VGA, вызывается с помощью IOCTL_VIDEO_ENABLE_VDM VRP. Затем драйвер мини-порта должен повторно инициализировать набор по умолчанию доступных портов ввода-вывода, которые могут включать в себя любые порты в массиве EmulatorAccessEntries .

Хотя предоставление полноэкранным приложениям MS-DOS на компьютерах с архитектурой x86 прямой доступ к видеопортам ускоряет операции видео, инициированные приложениями, каждый драйвер svGA-совместимого с VGA минипорта должен продолжать перехватывать подмножество критически важных портов ввода-вывода, чтобы предотвратить такое приложение от зависания компьютера. В частности, такие драйверы минипорта всегда должны перехватывать ввод-вывод приложения в последовательности адаптеров, совместимых с VGA, и прочие выходные регистры. Такой драйвер минипорта также должен перехватывать и проверять прямой ввод-вывод, выданный приложением, что может привести к зависаю компьютера для любого дополнительного подмножества портов ввода-вывода, зависящее от адаптера.

Повторный вызов VideoPortSetTrappedEmulatorPorts и сброс элемента RangeVisible элемента AccessRange в значение FALSE приводит к тому, что выданные приложением инструкции для этого диапазона будут перенаправляться в соответствующую функцию Драйвера мини-порта SvgaHwIoPortXxx .

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	video.h (включить Video.h)
Библиотека	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL