Fungsi StorPortMarkDeviceFailedEx (storport.h)

Artikel
02/26/2024

Rutinitas StorPortMarkDeviceFailedEx menandai perangkat dengan status gagal dan menyediakan data yang mungkin diperlukan untuk diagnosis.

Sintaks

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

Parameter

HwDeviceExtension

Arahkan ke ekstensi perangkat keras untuk adaptor bus host (HBA).

StorAddress

Alamat perangkat unit penyimpanan. Parameter ini NULL untuk perangkat adaptor.

Flags

Menunjukkan perilaku yang diminta oleh miniport. Bendera dapat diatur ke salah satu nilai berikut.

Bendera	Makna
STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE	Hapus perangkat yang gagal.
STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE	Menunjukkan bahwa ini adalah kegagalan perangkat yang diprediksi.

FaultCode

Kode kesalahan khusus miniport.

FaultDescription

String yang dapat dibaca manusia yang menggambarkan kesalahan.

AdditionalDataSize

Ukuran dalam byte buffer yang dituju oleh AdditionalData .

AdditionalData

Penunjuk ke buffer yang berisi data tambahan yang terkait dengan kondisi kesalahan.

CriticalDataSize

Ukuran dalam byte buffer yang dituju CriticalData .

CriticalData

Pointer ke buffer yang berisi data penting yang terkait dengan kondisi kesalahan.

Mengembalikan nilai

StorPortMarkDeviceFailedEx mengembalikan kode STOR_STATUS yang valid.

Keterangan

Driver miniport dapat memanggil fungsi ini untuk menandai perangkat yang gagal atau untuk menunjukkan bahwa perangkat berpotensi gagal.

Jika tidak ada bendera yang diatur di Bendera, Storport hanya akan mencatat peristiwa.

Manajer PnP akan mengirim IRP untuk mengkueri status PnP perangkat yang gagal. Jika Bendera diatur ke STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE dan tidak diatur ke STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE, manajer PnP kemudian akan mencoba menghapus perangkat yang gagal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, version 2004
Header	storport.h

Lihat juga

IoInvalidateDeviceState

StorPortMarkDeviceFailed

Bagikan melalui