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 ドライバーのミニポート ドライバーの 1 つによって使用される予約済みメンバー。 SCSI ミニポート ドライバーでは、このメンバーはコンテキスト値を指します。 SCSI ミニポート ドライバーのこのメンバーの意味の説明については、「HwScsiFindAdapter参照してください。

[in] BusInformation

Storport ドライバーのミニポート ドライバーの 1 つによって使用される予約済みメンバー。 SCSI ミニポート ドライバーでは、このメンバーは、OS 固有のポート ドライバーが収集したバスの種類固有の情報を指します。 SCSI ミニポート ドライバーのこのメンバーの意味の詳細については、「HwScsiFindAdapter参照してください。

[in] ArgumentString

Storport ドライバーのミニポート ドライバーの 1 つによって使用される予約済みメンバー。 SCSI ミニポート ドライバーでは、このメンバーは、基本パラメーターやレジストリからの割り込みレベルなどのデバイス情報を含む null で終わる ASCII 文字列を指します。 SCSI ミニポート ドライバーのこのメンバーの意味の詳細については、「HwScsiFindAdapter参照してください。

[in, out] ConfigInfo

HBA の構成情報を含む PORT_CONFIGURATION_INFORMATION 構造体へのポインター。

[out] Again

Storport ドライバーのミニポート ドライバーの 1 つによって使用される予約済みメンバー。 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を参照してください。

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	srb.h (Storport.h、Srb.h、Storport.h を含む)

関連項目

HwScsiFindAdapterの

HwStorFindAdapterの