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