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 迷你埠驅動程式時，此成員會指向作業系統特定埠驅動程式所收集的總線類型特定資訊。 如需 SCSI 迷你埠驅動程式之此成員意義的完整描述，請參閱 HwScsiFindAdapter。

[in] ArgumentString

由其中一個 Storport 驅動程式的迷你埠驅動程式使用時保留的成員。 使用 SCSI 迷你埠驅動程式時，此成員會指向以 Null 終止的 ASCII 字串，其中包含來自登錄的裝置資訊，例如基底參數或中斷層級。 如需 SCSI 迷你埠驅動程式之此成員意義的完整描述，請參閱 HwScsiFindAdapter。

[in, out] ConfigInfo

包含 HBA 組態資訊的 PORT_CONFIGURATION_INFORMATION 結構的指標。

[out] Again

由其中一個 Storport 驅動程式的迷你埠驅動程式使用時保留的成員。 使用 SCSI 迷你埠驅動程式時，此成員會指向 BOOLEAN 變數，告知埠驅動程式是否應該再次呼叫此例程。 如需 SCSI 迷你埠驅動程式之此成員意義的詳細資訊，請參閱 HwScsiFindAdapter。

傳回值

此原型所宣告的例程必須傳回下列其中一個狀態值：

傳回碼	Description
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