PDRIVER_IO_PORT_ULONG_STRING回调函数（video.h）

项目
02/07/2025

SvgaHwIoPortUlongString 捕获基于 x86 的计算机中的全屏 MS-DOS 应用程序发送一系列 ULONG 大小的数据的 I/O 端口范围。

语法

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

指定要捕获的映射 I/O 端口。

AccessMode

指定允许的访问类型，可以是以下值的一种或一种组合（ORed）：

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

指向要传输的 ULONG 数据字符串的指针。字符串一次挂出一个值，直到全部使用。

DataLength

指定字符串中的 ULONG 值数。

返回值

SvgaHwIoPortUlongString 返回作的最终状态。

言论

只有 VGA 兼容的 SVGA 适配器的微型端口驱动程序 SvgaHwIoPortXxx 函数。（请参阅 SVGA 函数。）

SvgaHwIoPortUlongString 截获全屏 MS-DOS 应用程序尝试的任何范围访问，或者 REP OUTSD DX、ESI 和 REP INSD EDI、DX的指令。

如果微型端口驱动程序通过调用 VideoSetTrappedEmulatorPorts启用端口范围，则不会调用其 SvgaHwIoPortUlongString 函数。然后，此类应用程序将直接访问 I/O 端口范围，除非微型端口驱动程序禁用端口范围，并再次调用 VideoSetTrappedEmulatorPorts。

如果一个或多个应用程序颁发的 x86 INSD 或 OUTSD 指令可能会影响 VGA 兼容的适配器序列器寄存器的状态，其他输出寄存器或任何特定于适配器的寄存器，因此，导致计算机挂起，微型端口驱动程序必须不通过调用 VideoPortSetTrappedEmulatorPorts来启用端口进行直接访问。

SvgaHwIoPortUlongString 必须缓冲应用程序中的后续指令，并检查是否可以挂起计算机。如果应用程序发出可能挂起计算机的指令序列，SvgaHwIoPortUlongString 必须放弃缓冲指令。否则，它应一次将 ULONG 输出到指定的映射 I/O 端口。

应 SvgaHwIoPortUlongString 进行分页。