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 例程都必须在微型端口驱动程序先零后调用 ScsiPortInitialize,然后设置HW_INITIALIZATION_DATA。

如果微型端口驱动程序可以在不同类型的 I/O 总线上支持 HBA,例如 IsaMicroChannel 类型 I/O 总线,微型端口驱动程序应为每个受支持的接口类型调用 ScsiPortInitialize

多次调用 ScsiPortInitialize 的微型端口驱动程序应检查每个调用 ScsiPortInitialize 返回的值,并为所有调用保存最低值。 DriverEntry 例程在向系统返回控件时必须返回最低值。 微型端口驱动程序编写器无法假设 ScsiPortInitialize返回的值。

要求

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

另请参阅

SCSI 微型端口驱动程序 DriverEntry

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter