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 ルーチンは、ミニポート ドライバーが最初にゼロになった後、ScsiPortInitialize を呼び出し、HW_INITIALIZATION_DATAを設定する必要があります。
ミニポート ドライバーがさまざまな種類の I/O バスで HBA をサポートできる場合 (Isa と MicroChannel タイプ I/O バスの両方など)、ミニポート ドライバーは、サポートされているインターフェイスの種類ごとに ScsiPortInitialize 呼び出す必要があります。
ScsiPortInitialize 複数回呼び出すミニポート ドライバーは、各呼び出しで ScsiPortInitialize によって返される値を確認し、そのすべての呼び出しの最小値を保存する必要があります。 DriverEntry ルーチンは、システムに制御を返すときに最小値を返す必要があります。 ミニポート ドライバーのライターは、ScsiPortInitialize によって返される値想定できません。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | srb.h (ミニポート h、Scsi.h を含む) |
| ライブラリ | Scsiport.lib |
関連項目
SCSI ミニポート ドライバー の DriverEntry
HwScsiFindAdapter の