次の方法で共有


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