Fungsi StorPortLogError (storport.h)
StorPortLogError rutin memberi tahu driver port bahwa terjadi kesalahan.
Sintaks
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 porta membebaskan memori ini ketika melepas perangkat.
[in, optional] Srb
Penunjuk ke blok permintaan SCSI jika dikaitkan dengan kesalahan. Jika tidak, parameter ini adalah NULL.
[in] PathId
Mengidentifikasi bus SCSI.
[in] TargetId
Mengidentifikasi pengontrol target atau perangkat pada bus.
[in] Lun
Mengidentifikasi nomor unit logis perangkat target.
[in] ErrorCode
Menentukan kode kesalahan yang menunjukkan 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. |
[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 ada
Keterangan
Driver 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 FungsiSrbSRB_FUNCTION_STORAGE_REQUEST_BLOCK, SRB adalah struktur permintaan STORAGE_REQUEST_BLOCK .
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | storport.h (termasuk Storport.h) |
Pustaka | Storport.lib |
Aturan kepatuhan DDI | StorPortDeprecated(storport) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk