StorPortMarkDeviceFailedEx, fonction (storport.h)

Article
02/07/2025

Le StorPortMarkDeviceFailedEx routine marque un appareil ayant échoué et fournit des 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 de l’appareil d’unité de stockage. Ce paramètre a la valeur NULL pour les périphériques d’adaptateur.

Flags

Indique le comportement demandé par le miniport. indicateurs peut être défini sur l’une des valeurs suivantes.

Drapeau	Signification
STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE	Supprimez l’appareil ayant échoué.
STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE	Indique qu’il s’agit d’une défaillance d’appareil prédite.

FaultCode

Code d’erreur spécifique à miniport.

FaultDescription

Chaîne lisible par l’homme 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 de retour

StorPortMarkDeviceFailedEx retourne un code de STOR_STATUS valide.

Remarques

Un pilote miniport peut appeler cette fonction pour marquer un appareil ayant échoué 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 ayant échoué. Si indicateurs est défini sur STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE et n’est pas défini sur STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE, le gestionnaire PnP tente ensuite de supprimer l’appareil ayant échoué.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 2004
d’en-tête	storport.h

Voir aussi

IoInvalidateDeviceState

StorPortMarkDeviceFailed

Partager via