VIDEO_ACCESS_RANGE構造 (video.h)

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

VIDEO_ACCESS_RANGE構造体は、ビデオアダプターのデバイス I/O ポートまたはメモリ範囲を定義します。すべてのミニポートドライバーの HwVidFindAdapter 関数は、ミニポートドライバーがサポートするビデオアダプターごとに、 アクセス範囲配列と呼ばれるVIDEO_ACCESS_RANGE型要素の配列を設定する必要があります。

VGA 互換ミニポートドライバーの場合、VIDEO_ACCESS_RANGEは VideoPortSetTrappedEmulatorPorts に渡される配列内の要素を定義して、全画面表示 MS-DOS アプリケーションによる I/O ポートへの直接アクセスを有効または無効にします。

構文

typedef struct _VIDEO_ACCESS_RANGE {
  PHYSICAL_ADDRESS RangeStart;
  ULONG            RangeLength;
  UCHAR            RangeInIoSpace;
  UCHAR            RangeVisible;
  UCHAR            RangeShareable;
  UCHAR            RangePassive;
} VIDEO_ACCESS_RANGE, *PVIDEO_ACCESS_RANGE;

メンバー

RangeStart

VideoPortVerifyAccessRanges に渡されるか、VideoPortGetAccessRanges によって返されるアクセス範囲配列内の要素のメモリまたは I/O ポート範囲のバス相対ベースアドレスを指定します。

VideoPortSetTrappedEmulatorPorts に渡される配列の I/O ポート範囲のバス相対ベースアドレスを指定します。

RangeLength

範囲の I/O ポートの数またはサイズ (バイト単位) を指定します。

RangeInIoSpace

範囲が I/O 領域にあるか、メモリ空間にあるかを指定します。 TRUE (1) の値は、範囲が I/O 領域にあることを示します。FALSE (0) の値は、範囲がメモリ空間内であることを示します。

RangeVisible

ミニポートドライバーの HwVidFindAdapter 関数がアクセス範囲配列を設定している場合は無視されます。

VGA 互換ミニポートドライバーによって TRUE に設定され、 VideoPortSetTrappedEmulatorPorts に渡され、全画面表示 MS-DOS アプリケーションによって I/O ポート範囲に直接アクセスできるようにします。 FALSE に設定した場合、アプリケーションが発行した命令は引き続きトラップされ、検証のためにミニポートドライバーの SvgaHwIoXxx 関数に転送されます。

RangeShareable

この要素で記述されているアクセス範囲を別のドライバーやデバイスと共有できる場合は TRUE に設定され、範囲を共有できない場合は FALSE に 設定されます。

VideoPortSetTrappedEmulatorPorts では無視されます。

RangePassive

デバイスが実際にポートを使用しているかどうかを示します。このメンバーの値を次の表に示します。

値	意味
VIDEO_RANGE_PASSIVE_DECODE	デバイスはポートをデコードしますが、ドライバーはそれを使用しません。
VIDEO_RANGE_10_BIT_DECODE	デバイスはポートアドレスの 10 ビットをデコードします。

注釈

ミニポートドライバーは、 DriverEntry または HwVidLegacyResources 関数でレガシリソースを要求する必要があります。

それ以外の場合、ミニポートドライバーの HwVidFindAdapter 関数は、アダプターの PCI リソースのアクセス範囲配列を設定します。 VideoPortGetAccessRanges によって返される情報を使用できます。代わりに、ミニポートドライバーが提供する HwVidQueryDeviceCallback 関数を使用して VideoPortGetDeviceData を呼び出すか、ミニポートドライバーが提供する HwVidQueryNamedValueCallback 関数を使用して VideoPortGetRegistryParameters を呼び出すことで、レジストリから取得した情報を使用できます。これらの VideoPortXxx を 呼び出してもバス相対アクセス範囲の値が提供されない場合、 HwVidFindAdapter はドライバー指定のバス相対既定値を使用してアクセス範囲の要素を設定できます。

レジストリでのアクセス範囲の要求

ミニポートドライバーは、VideoPortGetDeviceData、VideoPortGetAccessRanges から取得されたアクセス範囲、またはミニポートドライバーによって既定値として提供されるアクセス範囲で VideoPortVerifyAccessRanges を呼び出す必要があります。 VideoPortVerifyAccessRanges がこのようなアクセス範囲の配列のNO_ERRORを返す場合、HwVidFindAdapter または HwVidQueryDeviceCallback 関数は、範囲を VideoPortGetDeviceBase にマップし、返されたマップされた論理アドレスを使用してアダプターにアクセスできます。

VideoPortGetAccessRanges の呼び出しが成功すると、呼び出し元のレジストリで返されたバス相対アクセス範囲も要求されます。ミニポートドライバーが返された値のいずれかを変更する場合は、変更されていない要素を含むフルアクセス範囲で VideoPortVerifyAccessRanges を呼び出す必要があります。特定のビデオアダプターに対して VideoPortGetAccessRanges または VideoPortVerifyAccessRanges を呼び出すたびに、呼び出し元の要求されたハードウェアリソースがレジストリで上書きされます。

ミニポートドライバーは、 VideoPortVerifyAccessRanges または VideoPortGetAccessRanges がNO_ERRORを返さない範囲を使用しないでください。

アダプターと通信するためのアクセス範囲のマッピング

ミニポートドライバーがアダプターのレジストリ内のリソースを要求した後、HAL はすべてのバス相対デバイスアドレスをシステム空間に再マップできるため、バス相対アドレスを使用してアダプターにアクセスまたは構成することはできません。

ミニポートドライバーの HwVidFindAdapter 関数は、 VideoPortGetDeviceBase を呼び出して、アクセス範囲のマップされた論理アドレスを取得する必要があります。その後、ミニポートドライバーは、返されたマップされた論理範囲アドレスを VideoPortRead/WritePortXxx に渡して I/O 空間のデバイスメモリにアクセスし、 VideoPortRead/WriteRegisterXxx を 渡してメモリ空間内のデバイスメモリにアクセスすることで、ビデオアダプターと通信できます。

アクセス範囲が共有可能かどうかを判断する

次のガイドラインに従って、アクセス範囲を共有できるかどうかを判断します。

メモリまたは I/O ポートの範囲をこのドライバーによって "所有" する必要がある場合、および/または他のドライバーによってこの範囲にアクセスすると問題が発生する可能性がある場合は、 RangeSharable を FALSE に設定 します。
範囲を連携するデバイスドライバーと共有できる場合は、 RangeSharable を TRUE に設定 します。

すべての VGA 機能を実装する SVGA ミニポートドライバー (1 に設定された VgaCompatible としてレジストリで宣言) は、システム VGA ドライバーが読み込まれないように、アクセス範囲を非共有として要求する必要があります。一方、レジストリで VgaCompatible を 0 に設定した S3 や XGA などのアダプターのミニポートドライバーは、システム VGA ドライバーと共有するすべてのリソースを共有可能として要求する必要があります。

ただし、パススルー IOCTL で動作し、任意の VGA または SVGA カードに接続できるカードのミニポートドライバーは、システム VGA ポートまたはメモリ範囲を使用しないでください。その場合、そのようなドライバーは、レジストリ内の VGA アクセス範囲の要求を試みないでください。このようなミニポートドライバーによって VGA リソースを要求しようとすると、リソースの競合が発生する可能性があります。これは、マシン内の SVGA カードのドライバーが、これらのアクセス範囲を非共有として要求するためです。

I/O ポート範囲要素を VideoPortSetTrappedEmulatorPorts に渡す

x86 ベースのマシンの VGA 互換ミニポートドライバーが RangeVisible メンバーを 明示的に TRUE にリセットし、 VideoPortSetTrappedEmulatorPorts を呼び出して 1 つ以上の I/O ポート範囲を有効にしない限り、I/O ポート範囲を記述するすべてのVIDEO_ACCESS_RANGE型配列要素は非表示であると見なされます。 VideoPortSetTrappedEmulatorPorts は 、入力配列の RangeSharable メンバーを無視します。

VideoPortSetTrappedEmulatorPorts に渡されるVIDEO_ACCESS_RANGE型要素の配列で、各要素の RangeVisible メンバーの値は、指定された I/O ポートに VDM (x86 ベースのコンピューター上で全画面表示で実行されている MS-DOS アプリケーション) から直接アクセスできるかどうか、またはそのようなアプリケーションが発行した I/O ストリームをトラップしてミニポートドライバーが提供する SvgaHwIoPortXxx 関数に最初に転送するかどうかを決定します。