Fungsi ScsiPortLogError (srb.h)

Artikel
08/07/2023

ScsiPortLogError mencatat kesalahan ke log peristiwa sistem saat driver miniport atau HBA-nya mendeteksi kondisi kesalahan SCSI.

Catatan

Driver port SCSI dan model driver miniport SCSI dapat diubah atau tidak tersedia di masa mendatang. Gunakan driver Storport dan model driver miniport Storport sebagai gantinya.

Sintaks

SCSIPORT_API VOID ScsiPortLogError(
  PVOID               HwDeviceExtension,
  PSCSI_REQUEST_BLOCK Srb,
  UCHAR               PathId,
  UCHAR               TargetId,
  UCHAR               Lun,
  ULONG               ErrorCode,
  ULONG               UniqueId
);

Parameter

HwDeviceExtension

[in] Arahkan 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 HBA yang dipetakan. Area ini tersedia untuk driver miniport di deviceExtension-HwDeviceExtension> anggota objek perangkat HBA segera setelah driver miniport memanggil ScsiPortInitialize. Pengandar porta membebaskan memori ini ketika melepas perangkat.

Srb

[in, opsional] Penunjuk ke blok permintaan SCSI jika dikaitkan dengan kesalahan. Jika tidak, parameter ini adalah NULL.

PathId

[in] Mengidentifikasi bus SCSI.

TargetId

[in] Mengidentifikasi pengontrol target atau perangkat pada bus.

Lun

[in] Mengidentifikasi nomor unit logis perangkat target.

ErrorCode

[in] Menentukan kode kesalahan. Parameter ini bisa menjadi salah satu nilai berikut sebagai jenis kesalahan.

Nilai	Makna
SP_BAD_FW_ERROR	Menunjukkan 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 berkurangnya 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 tiba-tiba 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.

UniqueId

[in] Menentukan pengidentifikasi unik untuk kesalahan tersebut. Nilai ini membedakan kesalahan saat ini dari kesalahan lain dengan 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.

Menampilkan nilai

Tidak ada

Keterangan

Driver miniport harus mencatat semua kesalahan perangkat keras nyata. Namun, seharusnya tidak mencatat kesalahan operasional umum, seperti waktu habis pemilihan atau reset bus.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	srb.h (termasuk Miniport.h, Scsi.h)
Pustaka	Scsiport.lib

Lihat juga

ScsiPortNotification

Bagikan melalui