ScsiPortStallExecution 函式 (srb.h)

發行項
02/29/2024

ScsiPortStallExecution 例程會在迷你埠驅動程式中停止。

注意 SCSI 埠驅動程式和 SCSI 迷你埠驅動程式模型未來可能會改變或無法使用。相反地，我們建議使用 Storport 驅動程式和 Storport 迷你埠驅動程式模型。

語法

SCSIPORT_API VOID ScsiPortStallExecution(
  [in] ULONG Delay
);

參數

[in] Delay

指定毫秒的延遲間隔。指定的值必須小於完整毫秒。

傳回值

無

備註

應該盡可能呼叫 ScsiPortStallExecution，而迷你埠驅動程式例程中的停止時間總計必須小於 1 毫秒。此呼叫會系結處理器，在驅動程式中停止時不會執行有用的工作。

一般而言，迷你埠驅動程式只有在驅動程式必須等候 HBA 上無法中斷的狀態變更時，或驅動程式必須在存取 HBA 之間延遲非常短的間隔時，才呼叫 ScsiPortStallExecution 。

如果迷你埠驅動程式的 HwScsiInterrupt 例程必須在存取 HBA 之間停止，而 ISR 中的總延遲時間可能超過一毫秒，HwScsiInterrupt 應該使用 NotificationTypeCallEnableInterrupts 呼叫ScsiPortNotification，而不是呼叫 ScsiPortStallExecution。這類迷你埠驅動程式有一對 HwScsi。InterruptsCallback 例程可管理其插斷驅動 I/O 處理，而不需將處理器系結，並降低小型埠驅動程式可能在同一部機器中支援之其他 HBA 的 I/O 效能。

迷你埠驅動程式提供的 HwScsiTimer 例程也可以傳入呼叫 ScsiPortNotification ，其間隔不限於一毫秒。