ScsiPortStallExecution 函数 (srb.h)

项目
08/07/2023

ScsiPortStallExecution 例程在微型端口驱动程序中停止。

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

语法

SCSIPORT_API VOID ScsiPortStallExecution(
  [in] ULONG Delay
);

参数

[in] Delay

指定延迟间隔（以微秒为单位）。给定的值必须小于整毫秒。

返回值

无

备注

应尽可能少调用 ScsiPortStallExecution，并且微型端口驱动程序例程中的总停止时间必须小于一毫秒。此调用将处理器联系在一起，在驱动程序中停止时不执行任何有用的工作。

通常，微型端口驱动程序应仅当驱动程序必须等待 HBA 上的状态更改而不能导致中断，或者驱动程序必须在访问 HBA 之间延迟很短的间隔时，才应调用 ScsiPortStallExecution 。

如果微型端口驱动程序的 HwScsiInterrupt 例程必须在访问 HBA 之间停止，而 ISR 中的总延迟时间可能超过一毫秒，则 HwScsiInterrupt 应使用 NotificationTypeCallEnableInterrupts 调用 ScsiPortNotification，而不是调用 ScsiPortStallExecution。此类微型端口驱动程序具有一对 HwScsi。InterruptsCallback 例程，用于管理其中断驱动的 I/O 处理，而无需将处理器与微型端口驱动程序在同一台计算机中支持的其他 HBA 的 I/O 性能降低。

微型端口驱动程序提供的 HwScsiTimer 例程也可以在调用 ScsiPortNotification 时传递，其指定的间隔不限于一毫秒。