StorPortValidateRange 関数 (storport.h)

StorPortValidateRange ルーチンは、指定された I/O アドレス範囲が別のアダプターで使用されているかどうかを判断します。 このルーチンは、Windows NT 4.0 以降のオペレーティング システムでは廃止されています。

構文

STORPORT_API BOOLEAN StorPortValidateRange(
  [in] PVOID                 HwDeviceExtension,
  [in] INTERFACE_TYPE        BusType,
       ULONG                 SystemIoBusNumber,
  [in] STOR_PHYSICAL_ADDRESS IoAddress,
  [in] ULONG                 NumberOfBytes,
  [in] BOOLEAN               InIoSpace
);

パラメーター

[in] HwDeviceExtension

ハードウェア デバイス拡張機能へのポインター。 これは、ポート ドライバーがミニポート ドライバーの代わりに割り当ておよび初期化する HBA 記憶域ごとの です。 ミニポート ドライバーは通常、HBA の状態や HBA のマップされたアクセス範囲など、この拡張機能に HBA 固有の情報を格納します。 この領域は、ミニポート ドライバーが StorPortInitialize を呼び出した直後に、ミニポート ドライバーで使用できます。 ポート ドライバーは、デバイスを削除すると、このメモリを解放します。

[in] BusType

バスの種類を示 すSTORAGE_BUS_TYPE 型の値を格納します。

SystemIoBusNumber

システム バスを識別する整数を含みます。

[in] IoAddress

検証するアドレスの範囲の先頭アドレスが含まれます。

[in] NumberOfBytes

検証するアドレスの範囲の長さをバイト単位で格納します。

[in] InIoSpace

TRUE の場合、アドレス範囲が I/O 空間にあることを示します。 FALSE の場合、アドレスはメモリ空間内にあります。

戻り値

指定したアドレス範囲が別のドライバーによって要求されない場合、StorPortValidateRange は TRUE を返します。 別のドライバーがアドレス範囲を要求した場合、このルーチンは FALSE を 返します。

注釈

以前のバージョンの Windows との互換性のために、このルーチンは常に TRUE を返します。

ミニポート ドライバーには、Storport ドライバーがミニポートの HwStorFindAdapter コールバック ルーチンを呼び出すときに、PORT_CONFIGURATION_INFORMATION構造体の AccessRanges メンバーに有効な I/O 範囲が与えられます。

StorPortValidateRange は 、バス 相対アドレスを表すためにSTOR_PHYSICAL_ADDRESSを使用します。

typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;

STOR_PHYSICAL_ADDRESS型は、Storport ミニポート ドライバーが物理アドレスまたはバス相対アドレスを表すために使用するオペレーティング システムに依存しないデータ型です。

要件

こちらもご覧ください

ScsiPortValidateRange