ScsiPortInitialize 函数 (srb.h)
对于非即插即用微型端口驱动程序,ScsiPortInitialize 例程设置PORT_CONFIGURATION_INFORMATION结构,并调用微型端口驱动程序的 HwScsiFindAdapter 例程。 ScsiPortInitialize 还代表微型端口驱动程序设置系统对象和资源。 对于即插即用微型端口驱动程序,ScsiPortInitialize 存储微型端口驱动程序的初始化数据以供将来使用。
语法
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,例如 Isa 和 MicroChannel 类型 I/O 总线,微型端口驱动程序应为每个受支持的接口类型调用 ScsiPortInitialize。
多次调用 ScsiPortInitialize 的微型端口驱动程序应检查每个调用 ScsiPortInitialize 返回的值,并为所有调用保存最低值。 DriverEntry 例程在向系统返回控件时必须返回最低值。 微型端口驱动程序编写器无法假设 ScsiPortInitialize返回的值。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | srb.h (包括 Miniport.h、Scsi.h) |
库 | Scsiport.lib |
另请参阅
SCSI 微型端口驱动程序 的 DriverEntry