ACCESS_RANGE 構造体 (srb.h)

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

ACCESS_RANGEでは、HBA によって使用されるメモリまたは I/O ポート範囲について説明します。

メモ SCSI ポートドライバーと SCSI ミニポートドライバーモデルは、今後変更または使用できない可能性があります。代わりに、 Storport ドライバーと Storport ミニポートドライバーモデルを使用することをお勧めします。

構文

typedef struct _ACCESS_RANGE {
  SCSI_PHYSICAL_ADDRESS RangeStart;
  ULONG                 RangeLength;
  BOOLEAN               RangeInMemory;
} ACCESS_RANGE, *PACCESS_RANGE;

メンバー

RangeStart

範囲のバス相対ベースアドレスを指定する SCSI_PHYSICAL_ADDRESS 型のアドレスが含まれます。これは、 ScsiPortGetDeviceBase に渡すことができるアドレスです。

RangeLength

範囲内のポートのサイズ、バイト数、または数を指定します。ミニポートドライバーは、この値がアダプターによって実際にデコードされた範囲と一致することを確認する必要があります。たとえば、HBA が 7 つのレジスタを使用し、8 に応答する場合、このメンバーは 8 に設定する必要があります。

RangeInMemory

I/O 領域ではなく、 TRUE の場合に範囲がメモリ内に配置されていることを示します。 FALSE の場合、範囲は I/O 領域にあります。

注釈

各ACCESS_RANGEは、ミニポートドライバーの HwScsiFindAdapter ルーチンに渡されるPORT_CONFIGURATION_INFORMATION構造体内の AccessRanges 配列要素です。

可能であれば、OS 固有のポートドライバーは、ミニポートドライバーの HwScsiFindAdapter ルーチンを呼び出す前に、ミニポートドライバーのバス相対 HBA 範囲で各アクセス範囲要素を設定します。それ以外の場合、ポートドライバーは、構成情報を提供できない範囲要素をゼロにします。

ポートドライバーが範囲を指定する場合、ミニポートドライバーの HwScsiFindAdapter ルーチンは、指定されたアドレスのみを使用する必要があり、独自の工夫のアドレスを使用して、同じバス上の他の HBA を検索しようと しないでください 。ポートドライバーが範囲情報 (特に x86 実モードで初期化されている x86 専用システム) で他のバス相対ポートまたはメモリ範囲にアクセスしようとすると、バス上の他のデバイスが初期化に失敗したり、システムがブートプロセスを失敗させたりする可能性があります。

各ミニポートドライバーには、OS 固有のポートドライバーが情報を提供できない場合に試行するバス相対既定の範囲のセットが必要です。ミニポートドライバーは ScsiPortValidateRange を呼び出して、ミニポートドライバーが提供するアクセス範囲の安全性をチェックする必要があります。その前に、このような範囲を ScsiPortGetDeviceBase にマップし、返された論理アドレスを使用してアダプターにアクセスする必要があります(特に、HBA の 1 つに BIOS がある場合)。

ミニポートドライバーがPORT_CONFIGURATION_INFORMATIONの OS 固有のポートドライバーに対して入力するすべてのアクセス範囲には、バス相対アドレス (ScsiPortGetBusData によって返される値など) に RangeStart メンバーが設定されている必要があります。

ScsiPortGetDeviceBase によって返される対応する基本論理アドレスは、ScsiPortRead Xxx ルーチンと ScsiPortWriteXxx ルーチンを呼び出すために使用される I/O ポートまたはメモリアドレスのマップされた範囲の RangeStart アドレスとして、通常はミニポートドライバーのデバイス拡張機能に格納する必要があります。