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

Статья
08/07/2023

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

Синтаксис

PDRIVER_IO_PORT_ULONG_STRING PdriverIoPortUlongString;

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

Параметры

Context

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

Port

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

AccessMode

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

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

Указатель на строку данных ULONG для передачи. Строка подключается по одному значению за раз до тех пор, пока все оно не будет использовано.

DataLength

Указывает количество значений ULONG в строке.

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

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

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

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

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

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