Fungsi NdisWriteErrorLogEntry (ndis.h)
NdisWriteErrorLogEntry menulis entri ke file log kesalahan I/O sistem.
Sintaks
void NdisWriteErrorLogEntry(
[in] NDIS_HANDLE NdisAdapterHandle,
[in] NDIS_ERROR_CODE ErrorCode,
[in] ULONG NumberOfErrorValues,
...
);
Parameter
[in] NdisAdapterHandle
Menentukan handel yang mewakili NIC yang merupakan penyebab kesalahan I/O dicatat. Handel ini adalah parameter input untuk MiniportInitializeEx.
[in] ErrorCode
Menentukan kode NDIS_ERROR_CODE_XXX yang paling tepat menggambarkan kesalahan I/O sebagai salah satu nilai berikut:
NDIS_ERROR_CODE_RESOURCE_CONFLICT
Driver tidak dapat mengakses sumber daya yang diperlukan.
NDIS_ERROR_CODE_OUT_OF_RESOURCES
Perangkat keras atau driver kehabisan sumber daya.
NDIS_ERROR_CODE_HARDWARE_FAILURE
Pengandar mendeteksi kesalahan perangkat keras.
NDIS_ERROR_CODE_ADAPTER_NOT_FOUND
Adapter jaringan tidak ditemukan.
NDIS_ERROR_CODE_INTERRUPT_CONNECT
Pendaftaran interupsi gagal.
NDIS_ERROR_CODE_DRIVER_FAILURE
Terjadi kegagalan driver yang tidak cocok dengan kondisi kesalahan lainnya.
NDIS_ERROR_CODE_BAD_VERSION
Driver mendeteksi ketidakcocokan versi.
NDIS_ERROR_CODE_TIMEOUT
Batas waktu kedaluwarsa.
NDIS_ERROR_CODE_NETWORK_ADDRESS
Alamat jaringan tidak valid.
NDIS_ERROR_CODE_UNSUPPORTED_CONFIGURATION
Konfigurasi driver yang diminta tidak didukung.
NDIS_ERROR_CODE_INVALID_VALUE_FROM_ADAPTER
Perangkat keras adapter jaringan menyediakan nilai yang tidak valid.
NDIS_ERROR_CODE_MISSING_CONFIGURATION_PARAMETER
Parameter konfigurasi driver hilang di registri.
NDIS_ERROR_CODE_BAD_IO_BASE_ADDRESS
Alamat dasar I/O untuk perangkat keras adapter jaringan tidak valid.
NDIS_ERROR_CODE_RECEIVE_SPACE_SMALL
Jumlah memori buffer penerima yang tersedia terlalu kecil untuk menerima data.
NDIS_ERROR_CODE_ADAPTER_DISABLED
Piranti keras adapter jaringan dinon-fungsikan.
[in] NumberOfErrorValues
Menentukan jumlah nilai ULONG untuk mengikuti parameter ini.
...
Menentukan array ULONG berukuran variabel yang terkait dengan kesalahan yang akan dicatat.
Nilai kembali
Tidak ada
Keterangan
NdisWriteErrorLogEntry mengalokasikan catatan log kesalahan I/O, mengisi rekaman dengan informasi yang disediakan tentang kesalahan, lalu menulis catatan ke file log kesalahan I/O.
Sistem menempatkan batasan pada ukuran potensi catatan log kesalahan. Untuk Windows 2000 dan versi yang lebih baru, batas didefinisikan sebagai ERROR_LOG_MAXIMUM_SIZE. NumberOfErrorValues yang diteruskan ke NdisWriteErrorLogEntry oleh karena itu memiliki batas yang diberlakukan sistem, yang jauh kurang dari nilai maksimum yang mungkin untuk ULONG.
Dalam praktiknya, beberapa penelepon NdisWriteErrorLogEntry bahkan mendekati batas untuk NumberOfErrorValues karena menyediakan banyak nilai NDIS_STATUS_XXX tambahan tidak terlalu membantu bagi pengguna atau administrator sistem yang kemudian membaca log kesalahan, menggunakan penampil peristiwa Win32. Mencatat kesalahan I/O di setiap peluang yang mungkin tidak terlalu membantu pengguna, sehingga driver miniport harus mencatat hanya kesalahan I/O penting yang dapat membantu pengguna atau administrator sistem untuk men-debug kegagalan jaringan yang NIC bertanggung jawab pada komputer tertentu atau konflik sumber daya konfigurasi yang ditemukan selama inisialisasi driver.
Secara umum, driver miniport memanggil NdisWriteErrorLogEntry selama inisialisasi dari fungsi MiniportInitializeEx jika tidak dapat menginisialisasi NIC yang dikontrol atau tidak dapat mengalokasikan sumber daya perangkat keras yang diperlukan untuk melakukan operasi I/O pada NIC. Driver miniport juga dapat memanggil NdisWriteErrorLogEntry ketika operasi reset perangkat gagal karena kesalahan perangkat keras yang tidak dapat dipulihkan. Mencatat jenis kesalahan I/O ini membantu pengguna atau administrator sistem mengidentifikasi NIC atau NIC yang dikonfigurasi dengan buruk dengan komponen perangkat keras yang gagal.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisWriteErrorLogEntry (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisWriteErrorLogEntry (NDIS 5.1)) di Windows XP. |
| Target Platform | Universal |
| Header | ndis.h (termasuk Ndis.h) |
| Pustaka | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Aturan kepatuhan DDI | Irql_Miscellaneous_Function(ndis) |