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 迷你埠驅動程式時，此成員會指向 BOOLEAN 變數，告知埠驅動程式是否應該再次呼叫此例程。 如需 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