PDRIVER_IO_PORT_ULONG_STRING video.h (回呼函式)

發行項
02/26/2024

SvgaHwIoPortUlongString 會捕捉 x86 型機器中全螢幕 MS-DOS 應用程式的 I/O 連接埠範圍，以傳送一連串 ULONG 大小的數據。

語法

PDRIVER_IO_PORT_ULONG_STRING PdriverIoPortUlongString;

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

參數

Context

指定VIDEO_PORT_CONFIG_INFO的 EmulatorAccessEntriesContext 成員中設定的迷你埠驅動程式決定內容值。

Port

指定要截獲的對應 I/O 埠。

AccessMode

指定允許的存取類型，可以是下列值的一個或組合 (ORed) ：

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

要傳送之 ULONG 數據字串的指標。字串會一次攔截一個值，直到全部使用為止。

DataLength

指定字串中的 ULONG 值數目。

傳回值

SvgaHwIoPortUlongString 會傳回作業的最終狀態。

備註

只有 VGA 相容 SVGA 配接器的迷你埠驅動程式具有 SvgaHwIoPortXxx 函式。 (請參閱 SVGA Functions.)

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 應設為可分頁。