ScsiPortGetLogicalUnit 関数 (srb.h)

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

ScsiPortGetLogicalUnit ルーチンは、特定の周辺機器のミニポートドライバーの LU ごとの記憶域へのポインターを返します。

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

構文

SCSIPORT_API PVOID ScsiPortGetLogicalUnit(
  [in] PVOID HwDeviceExtension,
  [in] UCHAR PathId,
  [in] UCHAR TargetId,
  [in] UCHAR Lun
);

パラメーター

[in] HwDeviceExtension

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

[in] PathId

SCSI バスを識別します。

[in] TargetId

バス上のターゲットコントローラーまたはデバイスを識別します。

[in] Lun

ターゲットデバイスの論理ユニット番号を識別します。

戻り値

ScsiPortGetLogicalUnit は、要求された論理ユニットのミニポートドライバーの記憶域へのポインターを返します。オペレーティングシステム固有のポートドライバーで、この論理ユニットが存在しないと見なされる場合、 NULL が返されます。

注釈

ミニポートドライバーの DriverEntry ルーチンが ScsiPortInitialize と呼ばれるときに、HW_INITIALIZATION_DATAの LuExtensionSize に 0 を指定した場合、ScsiPortGetLogicalUnit は関係ありません。それ以外の場合、オペレーティングシステム固有のポートドライバーは、ミニポートドライバーが使用するために指定したサイズの LU 拡張機能のセットをゼロで割り当てて初期化します。

LU ごとのストレージを使用すると、保存されたデータポインターなど、特定の周辺機器に関連するデータを格納できます。この領域にアクセスするために、ミニポートドライバーは、ドライバーが特定の周辺機器の状態または現在の操作に関する情報を維持しているときに ScsiPortGetLogicalUnit を呼び出します。

オペレーティングシステム固有のポートドライバーは、論理ユニットに対するアクティブな要求がなく、デバイスが正常に選択されていない場合、論理ユニットが存在しないと見なすことができます。