Fonction StorPortLogError (storport.h)
La routine StorPortLogError avertit le pilote de port qu’une erreur s’est produite.
Syntaxe
STORPORT_API VOID StorPortLogError(
[in] PVOID HwDeviceExtension,
[in, optional] PSCSI_REQUEST_BLOCK Srb,
[in] UCHAR PathId,
[in] UCHAR TargetId,
[in] UCHAR Lun,
[in] ULONG ErrorCode,
[in] ULONG UniqueId
);
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 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, optional] Srb
Pointeur vers un bloc de requête SCSI s’il est associé à l’erreur. Sinon, ce paramètre a la valeur NULL.
[in] PathId
Identifie le bus SCSI.
[in] TargetId
Identifie le contrôleur ou l’appareil cible sur le bus.
[in] Lun
Identifie le numéro d’unité logique de l’appareil cible.
[in] ErrorCode
Spécifie un code d’erreur indiquant l’une des valeurs suivantes comme type d’erreur.
| Valeur | Signification |
|---|---|
| SP_BAD_FW_ERROR | Indique que le pilote a détecté un microprogramme défectueux ou ancien. L’appareil ne sera pas utilisé. |
| SP_BAD_FW_WARNING | Indique que le pilote a détecté un carte avec un microprogramme ancien ou incorrect, ce qui peut entraîner une réduction des performances ou des fonctionnalités. |
| SP_BUS_PARITY_ERROR | Indique qu’une erreur de parité de bus SCSI a été détectée. |
| SP_BUS_TIME_OUT | Indique qu’une connexion de bus SCSI à une unité logique a expiré. |
| SP_INTERNAL_ADAPTER_ERROR | Indique qu’une erreur HBA interne a été détectée. |
| SP_INVALID_RESELECTION | Indique une unité logique réélectionnée de manière inattendue ou avec une balise de file d’attente non valide. |
| SP_IRQ_NOT_RESPONDING | Indique que l’adaptateur HBA n’est pas interrompu quand on s’y attend. |
| SP_PROTOCOL_ERROR | Indique que le pilote miniport a détecté une erreur de protocole de bus SCSI. |
| SP_REQUEST_TIMEOUT | Indique qu’une opération sur le contrôleur a expiré. |
| SP_UNEXPECTED_DISCONNECT | Indique qu’une cible s’est déconnectée de manière inattendue. |
[in] UniqueId
Spécifie un identificateur unique pour l’erreur. Cette valeur différencie l’erreur actuelle des autres erreurs avec la même valeur ErrorCode . Pour certains pilotes miniport, cela identifie la ligne de code où l’erreur a été détectée. Pour d’autres, il s’agit d’informations supplémentaires retournées par l’adaptateur HBA.
Valeur de retour
None
Remarques
Le pilote de port consigne une erreur dans le journal des événements système.
À partir de Windows 8, le paramètre Srb peut pointer vers SCSI_REQUEST_BLOCK ou STORAGE_REQUEST_BLOCK. Si l’identificateur de fonction dans le champ Fonction de Srb est SRB_FUNCTION_STORAGE_REQUEST_BLOCK, le SRB est une structure de requête STORAGE_REQUEST_BLOCK .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | storport.h (inclure Storport.h) |
| Bibliothèque | Storport.lib |
| Règles de conformité DDI | StorPortDeprecated(storport) |