PHW_FIND_ADAPTER コールバック関数 (srb.h)
PHW_FIND_ADAPTERプロトタイプは、指定された構成を使用して特定の HBA がサポートされているかどうかを判断し、サポートされている場合はそのアダプターに関する構成情報を返すルーチンを宣言します。
構文
PHW_FIND_ADAPTER PhwFindAdapter;
ULONG PhwFindAdapter(
[in] PVOID DeviceExtension,
[in] PVOID HwContext,
[in] PVOID BusInformation,
[in] PCHAR ArgumentString,
[in, out] PPORT_CONFIGURATION_INFORMATION ConfigInfo,
[out] PBOOLEAN Again
)
{...}
パラメーター
[in] DeviceExtension
ミニポート ドライバーの HBA ごとの記憶域へのポインター。
[in] HwContext
Storport ドライバーのミニポート ドライバーのいずれかによって使用される予約済みメンバー。 SCSI ミニポート ドライバーでは、このメンバーはコンテキスト値を指します。 SCSI ミニポート ドライバーのこのメンバーの意味の説明については、「 HwScsiFindAdapter」を参照してください。
[in] BusInformation
Storport ドライバーのミニポート ドライバーのいずれかによって使用される予約済みメンバー。 SCSI ミニポート ドライバーでは、このメンバーは、OS 固有のポート ドライバーが収集したバスの種類固有の情報を指します。 SCSI ミニポート ドライバーのこのメンバーの意味の詳細については、「 HwScsiFindAdapter」を参照してください。
[in] ArgumentString
Storport ドライバーのミニポート ドライバーのいずれかによって使用される予約済みメンバー。 SCSI ミニポート ドライバーでは、このメンバーは、基本パラメーターやレジストリからの割り込みレベルなどのデバイス情報を含む null で終わる ASCII 文字列を指します。 SCSI ミニポート ドライバーのこのメンバーの意味の詳細については、「 HwScsiFindAdapter」を参照してください。
[in, out] ConfigInfo
HBA の構成情報を含む PORT_CONFIGURATION_INFORMATION 構造体へのポインター。
[out] Again
Storport ドライバーのミニポート ドライバーのいずれかによって使用される予約済みメンバー。 SCSI ミニポート ドライバーでは、このメンバーは、このルーチンを再度呼び出す必要があるかどうかをポート ドライバーに通知するブール値変数を指します。 SCSI ミニポート ドライバーのこのメンバーの意味の詳細については、「 HwScsiFindAdapter」を参照してください。
戻り値
このプロトタイプによって宣言されたルーチンは、次のいずれかの状態値を返す必要があります。
| リターン コード | 説明 |
|---|---|
| SP_RETURN_FOUND | サポートされている HBA が見つかり、HBA 関連の構成情報が正常に決定され、PORT_CONFIGURATION_INFORMATION構造体に設定されたことを示します。 |
| SP_RETURN_ERROR | HBA が見つかりましたが、構成情報の取得中にエラーが発生したことを示します。 可能であれば、このようなエラーは ScsiPortLogError でログに記録する必要があります。 |
| SP_RETURN_BAD_CONFIG | 指定された構成情報がアダプターに対して無効であることを示します。 |
| SP_RETURN_NOT_FOUND | 指定された構成情報に対してサポートされている HBA が見つからなかった場合を示します。 |
注釈
この宣言は、SCSI ミニポート ドライバーと StorPort ミニポート ドライバーの両方で使用されます。
この宣言に関連付けられているルーチンの SCSI ミニポート ドライバーのバージョンの詳細については、「 HwScsiFindAdapter」を参照してください。
この宣言に関連付けられている Storport ドライバーのルーチンのバージョンの詳細については、「 HwStorFindAdapter」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | srb.h (Storport.h、Srb.h、Storport.h を含む) |