StorPortMarkDeviceFailedEx, fonction (storport.h)

Article
02/29/2024

La routine StorPortMarkDeviceFailedEx marque un appareil dont la status a échoué et fournit les données qui peuvent être nécessaires pour le diagnostic.

Syntaxe

ULONG StorPortMarkDeviceFailedEx(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS StorAddress,
  ULONG         Flags,
  USHORT        FaultCode,
  PWSTR         FaultDescription,
  USHORT        AdditionalDataSize,
  PUCHAR        AdditionalData,
  USHORT        CriticalDataSize,
  PUCHAR        CriticalData
);

Paramètres

HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

StorAddress

Adresse du périphérique d’unité de stockage. Ce paramètre est NULL pour les périphériques adaptateurs.

Flags

Indique le comportement demandé par le miniport. Les indicateurs peuvent être définis sur l’une des valeurs suivantes.

Indicateur	Signification
STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE	Supprimez l’appareil défaillant.
STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE	Indique qu’il s’agit d’une défaillance prédite de l’appareil.

FaultCode

Code d’erreur spécifique au miniport.

FaultDescription

Chaîne lisible par l’utilisateur qui décrit l’erreur.

AdditionalDataSize

Taille en octets de la mémoire tampon vers laquelle pointe AdditionalData .

AdditionalData

Pointeur vers une mémoire tampon contenant des données supplémentaires associées à la condition d’erreur.

CriticalDataSize

Taille en octets de la mémoire tampon vers laquelle CriticalData pointe.

CriticalData

Pointeur vers une mémoire tampon contenant des données critiques associées à la condition d’erreur.

Valeur retournée

StorPortMarkDeviceFailedEx retourne un code STOR_STATUS valide.

Remarques

Un pilote miniport peut appeler cette fonction pour marquer un appareil défaillant ou pour indiquer que l’appareil a potentiellement échoué.

Si aucun indicateur n’est défini dans Indicateurs, Storport journalise uniquement l’événement.

Le gestionnaire PnP envoie un IRP pour interroger l’état PnP de l’appareil défaillant. Si Indicateurs est défini sur STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE et non sur STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE, le gestionnaire PnP tente alors de supprimer l’appareil défaillant.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 2004
En-tête	storport.h

Voir aussi

IoInvalidateDeviceState

StorPortMarkDeviceFailed

Partager via