Fungsi NdisWriteEventLogEntry (ndis.h)

Artikel
08/07/2023

NdisWriteEventLogEntry mencatat peristiwa ke log peristiwa Win32.

Sintaks

NDIS_STATUS NdisWriteEventLogEntry(
  [in]           PVOID       LogHandle,
  [in]           NDIS_STATUS EventCode,
  [in]           ULONG       UniqueEventValue,
  [in]           USHORT      NumStrings,
  [in, optional] PVOID       StringsList,
  [in]           ULONG       DataSize,
  [in, optional] PVOID       Data
);

Parameter

[in] LogHandle

Penunjuk ke objek pengandar protokol yang mencatat kejadian ini.

[in] EventCode

Menentukan kode NDIS_STATUS_XXX yang menjelaskan peristiwa.

[in] UniqueEventValue

Mengidentifikasi contoh pesan kesalahan ini.

[in] NumStrings

Menentukan jumlah penunjuk ke string Unicode dalam StringsList opsional. Jika StringsList adalah NULL, NumStrings harus nol.

[in, optional] StringsList

Baik NULL atau menunjuk ke string Unicode yang di-buffer. String ini, yang menjelaskan peristiwa, dimasukkan ke dalam log peristiwa Win32 dan dapat diperiksa dengan penampil peristiwa Win32. Setiap string harus berupa string Unicode yang dihentikan NUL.

[in] DataSize

Menentukan jumlah byte dalam buffer untuk data biner di Data . Jika DataNULL, DataSize harus nol.

[in, optional] Data

Baik NULL atau menunjuk ke data buffer biner dump yang berguna untuk memahami peristiwa. Data ini dapat diperiksa dengan penampil peristiwa Win32.

Nilai kembali

NdisWriteEventLogEntry dapat mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Kejadian berhasil dicatat.
NDIS_STATUS_BUFFER_TOO_SHORT	String Unicode yang disediakan secara opsional dan data cadangan biner melebihi ukuran maksimum yang diizinkan (MAX_EVENT_LOG_DATA_SIZE).
NDIS_STATUS_RESOURCES	NDIS tidak dapat mengalokasikan memori untuk rekaman log kesalahan I/O.

Keterangan

NdisWriteEventLogEntry mengalokasikan catatan log kesalahan I/O, mengisi rekaman dengan informasi yang disediakan tentang peristiwa tersebut, lalu menulis rekaman ke file log kesalahan I/O. Pengguna dapat melihat peristiwa yang dicatat, termasuk deskripsi opsional tentang peristiwa dan/atau data cadangan biner opsional, dengan penampil peristiwa Win32.

Utas pengelogan kesalahan NT menggunakan string apa pun yang disediakan dalam StringsList opsional untuk mengisi pesan yang ditulis ke dalam log peristiwa Win32. Setiap string harus berupa string Unicode yang dihentikan NUL. Manajer I/O mengasumsikan bahwa string awal adalah nama driver yang melaporkan kesalahan atau nama perangkat yang menyebabkan kesalahan.

String Unicode yang disediakan oleh pemanggil harus dibaca dari registri atau harus independen bahasa (artinya, string harus sama dalam bahasa apa pun -- misalnya, string bisa menjadi nama file).

Data cadangan yang disediakan penelepon dapat berupa data biner apa pun (seperti nilai register) yang berguna dalam memahami peristiwa tersebut. Pemanggil tidak perlu mengaitkan data biner. Jika perlu, NdisWriteEventLogEntry membandingkan data cadangan biner sehingga ukuran data akhir adalah beberapa integral sizeof (ULONG).

Sistem membatasi ukuran total data opsional yang disediakan untuk NdisWriteEventLogEntry. Ukuran gabungan daftar string dan cadangan biner (mungkin dilapisi) harus kurang dari atau sama dengan MAX_EVENT_LOG_DATA_SIZE.

NdisWriteEventLogEntry hanya dipanggil oleh driver protokol. Driver Miniport harus memanggil NdisWriteErrorLogEntry untuk mencatat peristiwa dan kesalahan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisWriteEventLogEntry (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisWriteEventLogEntry (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

NdisWriteErrorLogEntry

Bagikan melalui