PDRIVER_IO_PORT_UCHAR回呼函式（video.h）

發行項
02/07/2025

SvgaHwIoPortUchar 會擷取 x86 型電腦中全螢幕 MS-DOS 應用程式傳送 UCHAR 大小的數據。

語法

PDRIVER_IO_PORT_UCHAR PdriverIoPortUchar;

VP_STATUS PdriverIoPortUchar(
  ULONG_PTR Context,
  ULONG Port,
  UCHAR AccessMode,
  PUCHAR Data
)
{...}

參數

Context

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

Port

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

AccessMode

指定要截獲的存取類型，可以是下列值的其中一個或組合（ORed）：

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

要傳送之位元組的指標。

傳回值

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

言論

只有 VGA 相容 SVGA 適配卡的迷你埠驅動程式 SvgaHwIoPortXxx 函式。（請參閱 SVGA 函式。

SvgaHwIoPortUchar 攔截全螢幕 MS-DOS 應用程式嘗試的任何位元組存取，OUT DX、AL 和 IN AL、DX。

如果迷你埠驅動程式藉由呼叫 VideoPortSetTrappedEmulatorPorts來啟用埠，則不會呼叫其 SvgaHwIoPortUchar 函式。這類應用程式接著將可直接存取 Port，除非迷你埠驅動程式停用 Port，並透過另一個呼叫 VideoPortSetTrappedEmulatorPorts。

如果一或多個應用程式發出的 x86 IN 或 OUT 指令可能會影響 VGA 相容的配接器排序器緩存器、其他輸出緩存器或任何適配卡特定緩存器的狀態，因而導致計算機停止回應，迷你埠驅動程式必須不呼叫 VideoPortSetTrappedEmulatorPorts啟用埠以進行直接存取。

SvgaHwIoPortUchar 必須緩衝從應用程式到埠的後續指示，並檢查是否可以將機器停止回應。如果應用程式發出任何可能停止回應電腦的指令順序，SvgaHwIoPortUchar 必須捨棄緩衝的指令。否則，它應該一次將UCHAR輸出至指定的對應I/O埠。

SvgaHwIoPortUchar 應設為可分頁。