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

[アーティクル]
08/07/2023

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

構文

PDRIVER_IO_PORT_ULONG PdriverIoPortUlong;

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

パラメーター

Context

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

Port

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

AccessMode

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

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

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

戻り値

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

注釈

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

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

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

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

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

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