Partager via

Fonction StorPortLogError (storport.h)

  • Article

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)

Voir aussi

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

ScsiPortLogError

StorPortLogSystemEvent