次の方法で共有


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 を含む)

こちらもご覧ください

HwScsiFindAdapter

HwStorFindAdapter