Fungsi NdisWriteErrorLogEntry (ndis.h)

  • Artikel

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)

Lihat juga

MiniportInitializeEx

MiniportResetEx

NdisMSetMiniportAttributes