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