PDRIVER_IO_PORT_USHORT コールバック関数 (video.h)

[アーティクル]
02/29/2024

SvgaHwIoPortUshort は、x86 ベースのコンピューターの全画面表示 MS-DOS アプリケーションが USHORT サイズのデータのシーケンスを送信する I/O ポート範囲をトラップします。

構文

PDRIVER_IO_PORT_USHORT PdriverIoPortUshort;

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

パラメーター

Context

VIDEO_PORT_CONFIG_INFO の EmulatorAccessEntriesContext メンバーで設定されたミニポートドライバーによって決定されたコンテキスト値を指定します。

Port

トラップするマップされた I/O ポートを指定します。

AccessMode

次の値の 1 つまたは組み合わせ (ORed) を使用できる、許可されるアクセスの種類を指定します。

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

転送する USHORT データへのポインター。

戻り値

SvgaHwIoPortUshort は、操作の最終的な状態を返します。

注釈

VGA 互換 SVGA アダプターのミニポートドライバーにのみ 、SvgaHwIoPortXxx 関数があります。 ( 「SVGA 関数」を参照)。

SvgaHwIoPortUshort は、OUT DX、AX、IN AX、DX のいずれかの命令を発行する全画面 MS-DOS アプリケーションによって試行された範囲アクセスをインターセプトします。

ミニポートドライバーが VideoSetTrappedEmulatorPorts を呼び出して直接アクセスするためのポート範囲を有効にした場合、その SvgaHwIoPortUshort 関数は呼び出されません。このようなアプリケーションは、ミニポートドライバーが VideoSetTrappedEmulatorPorts への別の呼び出しでポート範囲を無効にしない限り、I/O ポート範囲に直接アクセスできます。

1 つ以上のアプリケーションが発行した x86 IN または OUT 命令が、VGA 互換アダプターシーケンサーレジスタ、その他の出力レジスタ、またはアダプター固有のレジスタの状態に影響を与える可能性があるため、コンピューターがハングする場合、ミニポートドライバーは VideoPortSetTrappedEmulatorPorts を呼び出して直接アクセスするためのポートを有効にしてはいけません。

SvgaHwIoPortUshort は、アプリケーションからの後続の命令をバッファーに格納し、コンピューターをハングできないチェックする必要があります。アプリケーションがコンピューターをハングする可能性のある一連の命令を発行した場合、 SvgaHwIoPortUshort は バッファー内の命令を破棄する必要があります。それ以外の場合は、一度に USHORT を、指定されたマップされた I/O ポートに出力する必要があります。

SvgaHwIoPortUshort を ページング可能にする必要があります。