ScsiPortInitialize 函数 (srb.h)

  • 项目

对于非即插即用微型端口驱动程序，ScsiPortInitialize 例程设置PORT_CONFIGURATION_INFORMATION结构并调用微型端口驱动程序的 HwScsiFindAdapter 例程。 ScsiPortInitialize 还代表微型端口驱动程序设置系统对象和资源。 对于即插即用微型端口驱动程序，ScsiPortInitialize 存储微型端口驱动程序的初始化数据，以供将来使用。

注意 SCSI 端口驱动程序和 SCSI 微型端口驱动程序模型将来可能会更改或不可用。 建议改用 Storport 驱动程序 和 Storport 微型端口 驱动程序模型。
 

语法

SCSIPORT_API ULONG ScsiPortInitialize(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] _HW_INITIALIZATION_DATA *HwInitializationData,
  [in] PVOID                   HwContext
);

参数

[in] Argument1

指向操作系统在其 DriverEntry 例程的第一个参数中传递给微型端口驱动程序的驱动程序对象的指针。

[in] Argument2

指向操作系统在 DriverEntry 的第二个参数中传递给微型端口驱动程序的某些上下文信息的指针。

[in] HwInitializationData

指向 DriverEntry 提供的初始化和配置信息的指针。

[in] HwContext

指定要传递给微型端口驱动程序 的 HwScsiFindAdapter 例程的上下文值的地址。 只有扫描总线中的 HBA 而不是从端口驱动程序接收配置信息的旧微型端口驱动程序才能使用此参数在调用 HwScsiFindAdapter 之间存储状态。

返回值

ScsiPortInitialize 返回一个状态值，该值用作微型端口驱动程序 DriverEntry 例程中的返回值。

注解

每个微型端口驱动程序的 DriverEntry 例程必须在微型端口驱动程序先归零然后设置HW_INITIALIZATION_DATA后调用 ScsiPortInitialize 。

如果微型端口驱动程序可以在不同类型的 I/O 总线（如 Isa 和 MicroChannel 类型 I/O 总线）上支持 HBA，则微型端口驱动程序应为每个受支持的接口类型调用 ScsiPortInitialize 。

多次调用 ScsiPortInitialize 的微型端口驱动程序应检查 ScsiPortInitialize 在每次调用时返回的值，并保存其所有调用的最小值。 DriverEntry 例程在将控件返回到系统时必须返回最小值。 微型端口驱动程序编写器不能对 ScsiPortInitialize 返回的值做出假设。

要求

要求 值
目标平台 桌面
标头 srb.h (包括 Miniport.h、Scsi.h)
Library Scsiport.lib

另请参阅

SCSI 微型端口驱动程序的 DriverEntry

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter