Fonction ScsiPortStallExecution (srb.h)

Article
03/01/2024

La routine ScsiPortStallExecution se bloque dans le pilote miniport.

Note Les modèles de pilote de port SCSI et de pilote miniport SCSI peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser les modèles de pilote Storport et de pilote Miniport Storport .

Syntaxe

SCSIPORT_API VOID ScsiPortStallExecution(
  [in] ULONG Delay
);

Paramètres

[in] Delay

Spécifie l’intervalle de délai en microsecondes. La valeur donnée doit être inférieure à une milliseconde complète.

Valeur de retour

None

Remarques

ScsiPortStallExecution doit être appelé aussi rarement que possible et le temps de décrochage total dans une routine de pilote miniport doit être inférieur à une milliseconde. Cet appel relie un processeur, n’effectuant aucun travail utile lors du blocage dans le pilote.

En général, un pilote miniport doit appeler ScsiPortStallExecution uniquement si le pilote doit attendre un changement d’état sur l’adaptateur HBA qui ne peut pas provoquer d’interruption, ou si le pilote doit retarder pendant un intervalle très court entre les accès à l’adaptateur HBA.

Si la routine HwScsiInterrupt d’un pilote miniport doit se bloquer entre les accès à l’adaptateur HBA et que le délai total dans l’ISR peut être supérieur à une milliseconde, HwScsiInterrupt doit appeler ScsiPortNotification avec notificationTypeCallEnableInterrupts au lieu d’appeler ScsiPortStallExecution. Un tel pilote miniport a une paire de HwScsi.. Interruptions Des routines d’appel pour gérer son traitement d’E/S piloté par les interruptions sans attacher un processeur et dégrader les performances d’E/S d’autres adaptateurs HBA que le pilote miniport peut prendre en charge sur le même ordinateur.

Une routine HwScsiTimer fournie par un pilote miniport peut également être passée dans les appels à ScsiPortNotification avec un intervalle spécifié qui n’est pas limité à une milliseconde.