PDRIVER_IO_PORT_USHORT_STRING回调函数 (video.h)

项目
02/29/2024

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

语法

PDRIVER_IO_PORT_USHORT_STRING PdriverIoPortUshortString;

VP_STATUS PdriverIoPortUshortString(
  ULONG_PTR Context,
  ULONG Port,
  UCHAR AccessMode,
  PUSHORT Data,
  ULONG DataLength
)
{...}

参数

Context

指定在 VIDEO_PORT_CONFIG_INFO 的 EmulatorAccessEntriesContext 中设置的微型端口驱动程序确定的上下文值。

Port

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

AccessMode

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

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

指向要传输的 USHORT 数据值字符串的指针。此字符串一次访问一个值，直到所有值都已挂钩。

DataLength

指定字符串中 USHORT 值的数目。

返回值

SvgaHwIoPortUshortString 返回操作的最终状态。

注解

只有 VGA 兼容 SVGA 适配器的微型端口驱动程序具有 SvgaHwIoPortXxx 函数。 (请参阅 SVGA Functions.)

SvgaHwIoPortUshortString 截获全屏 MS-DOS 应用程序发出 REP OUTSW DX、ESI 和 REP INSW EDI、 DX 指令或两个指令尝试的任何范围访问。

如果微型端口驱动程序通过调用 VideoSetTrappedEmulatorPorts 启用直接访问的端口范围，则不会调用其 SvgaHwIoPortUshortString 函数。这样，此类应用程序将可以直接访问 I/O 端口范围，除非微型端口驱动程序通过再次调用 VideoSetTrappedEmulatorPorts 来禁用端口范围。

如果一个或多个应用程序发布的 x86 INSW 或 OUTSW 指令可能会影响 VGA 兼容的适配器排序器寄存器、杂项输出寄存器或任何特定于适配器的寄存器的状态，从而导致计算机挂起，微型端口驱动程序不得通过调用 VideoPortSetTrappedEmulatorPorts 来启用端口以便直接访问。

SvgaHwIoPortUshortString 必须缓冲来自应用程序的后续指令，并检查没有人可以挂起计算机。如果应用程序发出任何可能挂起计算机的指令序列， SvgaHwIoPortUshortString 必须放弃缓冲的指令。否则，它应将它们（一次一个 USHORT）输出到指定的映射 I/O 端口。

SvgaHwIoPortUshortString 应可分页。