Fonction StorPortDeviceBusy (storport.h)

La routine StorPortDeviceBusy avertit le pilote de port que l’unité logique spécifiée est actuellement occupée et gère les demandes en suspens.

Syntaxe

STORPORT_API BOOLEAN StorPortDeviceBusy(
  [in] PVOID HwDeviceExtension,
  [in] UCHAR PathId,
  [in] UCHAR TargetId,
  [in] UCHAR Lun,
  [in] ULONG RequestsToComplete
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel. Il s’agit d’une zone de stockage par HBA que le pilote de port alloue et initialise pour le compte du pilote miniport. Les pilotes miniport stockent généralement des informations spécifiques à L’adaptateur HBA dans cette extension, telles que l’état de l’adaptateur HBA et les plages d’accès mappées pour l’adaptateur HBA. Cette zone est disponible pour le pilote miniport immédiatement après que le pilote miniport a appelé StorPortInitialize. Le pilote de port libère cette mémoire lorsqu’il supprime l’appareil.

[in] PathId

Identifie le bus SCSI.

[in] TargetId

Identifie le contrôleur ou l’appareil cible sur les bus donnés.

[in] Lun

Identifie l’unité logique pour le contrôleur ou l’appareil cible donné.

[in] RequestsToComplete

Indique le nombre de requêtes que l’unité logique doit effectuer avant de reprendre les demandes d’E/S adressées au pilote miniport. Si RequestsToComplete est supérieur au nombre de demandes actuellement en attente, le pilote Storport effectue toutes les demandes en suspens à l’unité logique avant de reprendre les demandes.

Valeur retournée

StorPortDeviceBusy retourne TRUE si le pilote miniport a réussi à notifier le pilote de port, FALSE si ce n’est pas le cas.

Remarques

Aucun journal des erreurs n’est généré lorsqu’un appareil est occupé.

Le pilote de port n’émet pas de nouvelles demandes à l’unité logique tant que la file d’attente de l’unité logique n’a pas été vidée à un niveau suffisant pour que le traitement puisse continuer.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	storport.h (inclure Storport.h)
Bibliothèque	Storport.lib

Voir aussi

StorPortBusy

StorPortReady