Fungsi StorPortLogError (storport.h)

2025-02-07

StorPortLogError rutin memberi tahu driver port bahwa terjadi kesalahan.

Sintaksis

STORPORT_API VOID StorPortLogError(
  [in]           PVOID               HwDeviceExtension,
  [in, optional] PSCSI_REQUEST_BLOCK Srb,
  [in]           UCHAR               PathId,
  [in]           UCHAR               TargetId,
  [in]           UCHAR               Lun,
  [in]           ULONG               ErrorCode,
  [in]           ULONG               UniqueId
);

Parameter

[in] HwDeviceExtension

Penunjuk ke ekstensi perangkat keras. Ini adalah area penyimpanan per HBA yang dialokasikan dan diinisialisasi driver port atas nama driver miniport. Driver miniport biasanya menyimpan informasi khusus HBA dalam ekstensi ini, seperti status HBA dan rentang akses yang dipetakan untuk HBA. Area ini tersedia untuk miniport segera setelah driver miniport memanggil StorPortInitialize. Pengandar port membebaskan memori ini ketika melepas perangkat.

[in, optional] Srb

Penunjuk ke blok permintaan SCSI jika dikaitkan dengan kesalahan. Jika tidak, parameter ini null.

[in] PathId

Mengidentifikasi bus SCSI.

[in] TargetId

Mengidentifikasi pengontrol target atau perangkat di bus.

[in] Lun

Mengidentifikasi nomor unit logis perangkat target.

[in] ErrorCode

Menentukan kode kesalahan yang menunjukkan salah satu nilai berikut sebagai jenis kesalahan.

Nilai	Arti
SP_BAD_FW_ERROR	Menunjukkan bahwa driver telah mendeteksi firmware yang buruk atau lama. Perangkat tidak akan digunakan.
SP_BAD_FW_WARNING	Menunjukkan driver telah mendeteksi kartu dengan firmware lama atau buruk, yang dapat mengakibatkan penurunan performa atau fungsionalitas.
SP_BUS_PARITY_ERROR	Menunjukkan kesalahan paritas bus SCSI terdeteksi.
SP_BUS_TIME_OUT	Menunjukkan koneksi bus SCSI ke unit logis yang kehabisan waktu.
SP_INTERNAL_ADAPTER_ERROR	Menunjukkan kesalahan HBA internal terdeteksi.
SP_INVALID_RESELECTION	Menunjukkan unit logis dipilih kembali secara tak terduga atau dengan tag antrean yang tidak valid.
SP_IRQ_NOT_RESPONDING	Menunjukkan HBA tidak mengganggu ketika diharapkan.
SP_PROTOCOL_ERROR	Menunjukkan driver miniport mendeteksi kesalahan protokol bus SCSI.
SP_REQUEST_TIMEOUT	Menunjukkan operasi ke pengontrol telah kehabisan waktu.
SP_UNEXPECTED_DISCONNECT	Menunjukkan bahwa target terputus secara tak terduga.

[in] UniqueId

Menentukan pengidentifikasi unik untuk kesalahan tersebut. Nilai ini membedakan kesalahan saat ini dari kesalahan lain dengan nilai ErrorCode yang sama. Untuk beberapa driver miniport, ini mengidentifikasi baris kode tempat kesalahan terdeteksi. Untuk yang lain, ini adalah informasi tambahan yang dikembalikan oleh HBA.

Mengembalikan nilai

Tidak

Komentar

Pengandar porta akan mencatat kesalahan ke log kejadian sistem.

Mulai dari Windows 8, parameter Srb dapat menunjuk ke SCSI_REQUEST_BLOCK atau STORAGE_REQUEST_BLOCK. Jika pengidentifikasi fungsi di bidang Fungsi Srb SRB_FUNCTION_STORAGE_REQUEST_BLOCK, SRB adalah struktur permintaan STORAGE_REQUEST_BLOCK.