StorPortMarkDeviceFailedEx-Funktion (storport.h)

Artikel
02/29/2024

Die StorPortMarkDeviceFailedEx-Routine markiert ein Gerät mit fehlerhafter status und stellt Daten bereit, die möglicherweise für die Diagnose benötigt werden.

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 Host Bus Adapter (HBA).

StorAddress

Geräteadresse der Speichereinheit. 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.

Flag	Bedeutung
STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE	Entfernen Sie das fehlerhafte Gerät.
STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE	Gibt an, dass dies ein vorhergesagter Gerätefehler ist.

FaultCode

Miniportspezifischer Fehlercode.

FaultDescription

Für Menschen lesbare Zeichenfolge, die den Fehler beschreibt.

AdditionalDataSize

Größe in Bytes des Puffers, auf den AdditionalData verweist.

AdditionalData

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

CriticalDataSize

Größe in Bytes des Puffers, auf den CriticalData verweist.

CriticalData

Zeiger auf einen Puffer mit kritischen Daten, die der Fehlerbedingung zugeordnet sind.

Rückgabewert

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

Hinweise

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

Wenn in Flags keine Flags 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
Unterstützte Mindestversion (Client)	Windows 10, Version 2004
Kopfzeile	storport.h

Weitere Informationen

IoInvalidateDeviceState

StorPortMarkDeviceFailed

Freigeben über