StorPortMarkDeviceFailedEx-Funktion (storport.h)

Artikel
02/07/2025

Die StorPortMarkDeviceFailedEx- Routine kennzeichnet ein Gerät mit fehlgeschlagenem Status und stellt Daten bereit, die möglicherweise für die Diagnose erforderlich sind.

Syntax

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

Parameter

HwDeviceExtension

Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA).

StorAddress

Adresse des Speichergeräts. Dieser Parameter ist NULL für Adaptergeräte.

Flags

Gibt das Verhalten an, das vom Miniport angefordert wird. Flags können auf einen der folgenden Werte festgelegt werden.

Flagge	Bedeutung
STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE	Entfernen Sie das fehlgeschlagene Gerät.
STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE	Gibt an, dass dies ein vorhergesagter Geräteausfall ist.

FaultCode

Miniportspezifischer Fehlercode.

FaultDescription

Lesbare Zeichenfolge, die den Fehler beschreibt.

AdditionalDataSize

Größe in Byte des Puffers, auf den additionalData verweist.

AdditionalData

Zeigen Sie auf einen Puffer, der zusätzliche Daten enthält, die der Fehlerbedingung zugeordnet sind.

CriticalDataSize

Größe in Byte des Puffers, auf den criticalData verweist,.

CriticalData

Zeigen Sie auf einen Puffer, der kritische Daten enthält, die der Fehlerbedingung zugeordnet sind.

Rückgabewert

StorPortMarkDeviceFailedEx gibt einen gültigen STOR_STATUS Code zurück.

Bemerkungen

Ein Miniporttreiber kann diese Funktion aufrufen, um ein fehlerhaftes Gerät zu markieren oder anzugeben, dass das Gerät möglicherweise fehlgeschlagen ist.

Wenn in Flagskeine Kennzeichnungen festgelegt sind, protokolliert Storport nur das Ereignis.

Der PnP-Manager sendet ein IRP, um den PnP-Zustand des fehlerhaften Geräts abzufragen. Wenn Flags auf STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE und nicht auf STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE festgelegt ist, versucht der PnP-Manager dann, das fehlerhafte Gerät zu entfernen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 2004
Header-	storport.h

Siehe auch

IoInvalidateDeviceState

StorPortMarkDeviceFailed

Freigeben über