Storport ドライバーのミニポート ルーチン
Storport ドライバーで動作するミニポート ドライバーには、このセクションに記載されているルーチンの説明の実装が含まれている必要があります。また、ミニポート ドライバーの初期化フェーズ中に HW_INITIALIZATION_DATA 構造を介して公開する必要があります。
Storport ミニポート ドライバー ルーチンは、ほとんどの点で 相当する SCSI ポートに対応します。 ただし、SCSI ポート ドライバーの設計と Storport ドライバーの設計には重要な違いがあり、ミニポート ルーチンではこの違いに対応する必要があります。
次に例を示します。
- Storport ミニポート ドライバーは、HwStorStartIo ルーチンの完了後に、別の I/O 要求を受信するように常に準備する必要があります。
- SCSI ミニポート ドライバーには、この要件はありません。 StorPortNotificationを呼び出して別の要求を処理できる場合、ポート ドライバーに明示的に通知するまで、新しい I/O 要求を受け取りません。
Storport ミニポート ドライバーが送信された要求をすぐに処理できない場合は、オーバーロードを処理できる一連のキュー管理関数があります。 これらのキュー管理機能は、SCSI ミニポート ドライバーでは使用できません。 SCSI ミニポート ドライバーと同様に、Storport ミニポート ドライバーは、SRB_STATUS_BUSY を使用して要求を完了します。 ただし、SCSI ポートのバージョンとは異なり、StorPortDeviceBusy ルーチンを使用して、デバイス キューをビジーとしてマークすることもできます。 同様の関数を使用すると、Storport ミニポート ドライバーはアダプター全体で処理を一時停止および再開できます。
Storport ドライバーによって提供されるサポート ルーチンの詳細については、Storport ドライバーのサポート ルーチンを参照してください。
Storport ドライバーの詳細については、ストレージ ポート ドライバーを参照してください。
Storport ミニポート ドライバー ルーチンのリスト
| ルーチンによって返される値 | 説明 |
|---|---|
| HW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE | メッセージ通知割り込み (MSI) を処理します。 |
| HW_ADAPTER_CONTROL | 電源管理のために HBA の停止や再起動など、アダプターの状態または動作を制御する同期操作を実行します。 |
| HW_BUILDIO | 共有システム データ構造への同期されていないアクセス権を持つ SRB を処理してから、HwStorStartIo に渡します。 |
| HW_DPC_ROUTINE | 遅延プロシージャ呼び出し (DPC) メカニズムを使用して DISPATCH IRQL で実行するために遅延されるルーチン。 |
| HW_FIND_ADAPTER | 指定された構成を使用して、特定の HBA がサポートされているかどうかを判断し、サポートされている場合は、そのアダプターに関する構成情報を返します。 |
| HW_INITIALIZE | システムの再起動または電源障害が発生した後、ミニポート ドライバーを初期化します。 |
| HW_INTERRUPT | Storport ドライバーは、HBA が 割り込み要求を生成した後、HwStorInterrupt ルーチンを呼び出します。 |
| HW_PASSIVE_INITIALIZE_ROUTINE | 現在の IRQL が PASSIVE_LEVEL にあるときに HwStorInitialize ルーチンの後に呼び出されます。 |
| HW_RESET_BUS | エラー状態をクリアするためにポート ドライバーによって呼び出されます。 |
| HW_STARTIO | Storport ドライバーは、受信 I/O 要求ごとに HwStorStartIo ルーチンを 1 回呼び出します。 |
| HW_TIMER | ミニポート ドライバーが RequestTimerCall NotificationType 値を持つ StorPortNotification を呼び出す際に指定された間隔の後に呼び出されます。 |
| HW_TRACING_ENABLED | Storport で、イベント トレースが有効になっていることをミニポートに通知できるようにします。 |
| HW_UNIT_CONTROL | ストレージ ユニット デバイスの状態を制御する同期操作を実行するために呼び出されます。 ミニポート ドライバーは、ユニットを開始するか、ユニット デバイスの電源状態遷移を処理するように通知されます。 |
| HW_WORKITEM | Storport 作業項目要求を処理するためのミニポート提供のコールバック関数。 |