ScsiPortInitialize 関数 (srb.h)
プラグ アンド プレイ以外のミニポート ドライバーの場合、ScsiPortInitialize ルーチンはPORT_CONFIGURATION_INFORMATION構造体を設定し、ミニポート ドライバーの HwScsiFindAdapter ルーチンを呼び出します。 ScsiPortInitialize は、ミニポート ドライバーの代わりにシステム オブジェクトとリソースも設定します。 プラグ アンド プレイ ミニポート ドライバーの場合、ScsiPortInitialize は、将来使用するためにミニポート ドライバーの初期化データを格納します。
構文
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 によって返される値に関する仮定を行うことができます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | srb.h (Miniport.h、Scsi.h を含む) |
| Library | Scsiport.lib |