ScsiPortInitialize 関数 (srb.h)

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

プラグアンドプレイ以外のミニポートドライバーの場合、ScsiPortInitialize ルーチンはPORT_CONFIGURATION_INFORMATION構造体を設定し、ミニポートドライバーの HwScsiFindAdapter ルーチンを呼び出します。 ScsiPortInitialize は、ミニポートドライバーの代わりにシステムオブジェクトとリソースも設定します。プラグアンドプレイミニポートドライバーの場合、ScsiPortInitialize は、将来使用するためにミニポートドライバーの初期化データを格納します。

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

構文

SCSIPORT_API ULONG ScsiPortInitialize(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] _HW_INITIALIZATION_DATA *HwInitializationData,
  [in] PVOID                   HwContext
);

パラメーター

[in] Argument1

オペレーティングシステムが DriverEntry ルーチンの最初の引数でミニポートドライバーに渡したドライバーオブジェクトへのポインター。

[in] Argument2

オペレーティングシステムが DriverEntry の 2 番目の引数でミニポートドライバーに渡したコンテキスト情報へのポインター。

[in] HwInitializationData

DriverEntry によって提供される初期化情報と構成情報へのポインター。

[in] HwContext

ミニポートドライバーの HwScsiFindAdapter ルーチンに渡されるコンテキスト値のアドレスを指定します。ポートドライバーから構成情報を受信するのではなく、HBA のバスをスキャンするレガシミニポートドライバーのみが、 HwScsiFindAdapter への呼び出し間の状態を格納するには、このパラメーターを使用できます。

戻り値

ScsiPortInitialize は、ミニポートドライバーの DriverEntry ルーチンからの戻り値として使用される状態値を返します。

注釈

すべてのミニポートドライバーの DriverEntry ルーチンは、ミニポートドライバーが最初にゼロになった後、HW_INITIALIZATION_DATAを設定した後に ScsiPortInitialize を呼び出す必要があります。

ミニポートドライバーが Isa と MicroChannel の両方の種類の I/O バスなど、さまざまな種類の I/O バスで HBA をサポートできる場合、ミニポートドライバーは、サポートされているインターフェイスの種類ごとに ScsiPortInitialize を呼び出す必要があります。

ScsiPortInitialize を複数回呼び出すミニポートドライバーは、各呼び出しで ScsiPortInitialize によって返される値をチェックし、そのすべての呼び出しの最小値を保存する必要があります。 DriverEntry ルーチンは、コントロールをシステムに返すときに、最小値を返す必要があります。ミニポートドライバーのライターは、 ScsiPortInitialize によって返される値に関する仮定を行うことができます。