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