NdisWriteEventLogEntry 函式 （ndis.h）
NdisWriteEventLogEntry 將事件記錄至 Win32 事件記錄檔。
語法
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
);
參數
[in] LogHandle
記錄此事件的通訊協定驅動程式物件的指標。
[in] EventCode
指定描述事件的NDIS_STATUS_XXX 程式代碼。
[in] UniqueEventValue
識別錯誤訊息的這個實例。
[in] NumStrings
指定選擇性 StringsList中 Unicode 字串的指標數目。 如果 StringsListNULL，NumStrings 必須是零。
[in, optional] StringsList
NULL 或指向緩衝的 Unicode 字串。 這些描述事件的字串會插入 Win32 事件記錄檔中，而且可以使用 Win32 事件查看器來檢查。 每個字串都必須是 NUL 終止的 Unicode 字串。
[in] DataSize
在 Data 指定二進位數據緩衝區中的位元元數目。 如果 數據NULL，DataSize 必須是零。
[in, optional] Data
NULL 或指向緩衝的二進位傾印數據，有助於瞭解事件。 您可以使用 Win32 事件檢視器來檢查此資料。
傳回值
NdisWriteEventLogEntry 可以傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
|
已成功記錄事件。 |
|
選擇性提供的 Unicode 字串和二進位傾印資料超過允許的大小上限（MAX_EVENT_LOG_DATA_SIZE）。 |
|
NDIS 無法為 I/O 錯誤記錄配置記憶體。 |
言論
NdisWriteEventLogEntry 配置 I/O 錯誤記錄檔、填入記錄中提供的事件資訊，然後將記錄寫入 I/O 錯誤記錄檔。 使用者可以檢視記錄的事件，包括事件和/或選擇性二進位傾印數據的選擇性描述，以及 Win32 事件查看器。
NT 錯誤記錄線程會使用選擇性 StringsList 中提供的任何字串， 填入寫入 Win32 事件記錄檔的訊息。 每個字串都必須是 NUL 終止的 Unicode 字串。 I/O 管理員假設初始字串是回報錯誤的驅動程式名稱或造成錯誤的裝置名稱。
呼叫端提供的 Unicode 字串應該從登錄讀取，或應該與語言無關（也就是說，字串在任何語言中都應該相同，例如字串可以是檔名）。
呼叫端提供的傾印數據可以是任何二進位數據（例如緩存器值），有助於瞭解事件。 呼叫端不需要填補二進位數據。 如有必要，NdisWriteEventLogEntry 填補二進位傾印數據，讓最終數據大小是 sizeof（ULONG） 的多個整數。
系統會限制提供給 NdisWriteEventLogEntry的選擇性數據大小總計。 字串清單和 （可能填補） 二進位傾印的合併大小必須小於或等於MAX_EVENT_LOG_DATA_SIZE。
NdisWriteEventLogEntry 只會由通訊協定驅動程式呼叫。 迷你埠驅動程序應該呼叫 NdisWriteErrorLogEntry 來記錄事件和錯誤。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式（請參閱 NdisWriteEventLogEntry （NDIS 5.1）。 支援 NDIS 5.1 驅動程式（請參閱 Windows XP 中的 NdisWriteEventLogEntry （NDIS 5.1）。 |
| 目標平臺 | 普遍 |
| 標頭 | ndis.h （包括 Ndis.h） |
| 連結庫 | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | Irql_Miscellaneous_Function（ndis） |