NdisWriteErrorLogEntry 函式 （ndis.h）
NdisWriteErrorLogEntry 將專案寫入系統 I/O 錯誤記錄檔。
語法
void NdisWriteErrorLogEntry(
[in] NDIS_HANDLE NdisAdapterHandle,
[in] NDIS_ERROR_CODE ErrorCode,
[in] ULONG NumberOfErrorValues,
...
);
參數
[in] NdisAdapterHandle
指定表示 NIC 的句柄，這是記錄 I/O 錯誤的原因。 此句柄是 MiniportInitializeEx的輸入參數。
[in] ErrorCode
指定最能將 I/O 錯誤描述為下列其中一個值的NDIS_ERROR_CODE_XXX 程式代碼：
NDIS_ERROR_CODE_RESOURCE_CONFLICT
驅動程式無法存取必要的資源。
NDIS_ERROR_CODE_OUT_OF_RESOURCES
硬體或驅動程式用盡資源。
NDIS_ERROR_CODE_HARDWARE_FAILURE
驅動程式偵測到硬體錯誤。
NDIS_ERROR_CODE_ADAPTER_NOT_FOUND
找不到網路適配器。
NDIS_ERROR_CODE_INTERRUPT_CONNECT
中斷註冊失敗。
NDIS_ERROR_CODE_DRIVER_FAILURE
發生驅動程序失敗，不符合任何其他錯誤狀況。
NDIS_ERROR_CODE_BAD_VERSION
驅動程式偵測到版本不符。
NDIS_ERROR_CODE_TIMEOUT
逾時已過期。
NDIS_ERROR_CODE_NETWORK_ADDRESS
網路地址無效。
NDIS_ERROR_CODE_UNSUPPORTED_CONFIGURATION
不支援要求的驅動程序設定。
NDIS_ERROR_CODE_INVALID_VALUE_FROM_ADAPTER
網路適配器硬體提供無效的值。
NDIS_ERROR_CODE_MISSING_CONFIGURATION_PARAMETER
登錄中遺漏驅動程式組態參數。
NDIS_ERROR_CODE_BAD_IO_BASE_ADDRESS
網路適配器硬體的 I/O 基地址無效。
NDIS_ERROR_CODE_RECEIVE_SPACE_SMALL
可用的接收緩衝區內存數量太小，無法接收數據。
NDIS_ERROR_CODE_ADAPTER_DISABLED
網路適配器硬體已停用。
[in] NumberOfErrorValues
指定要遵循此參數的 ULONG 值數目。
...
指定要記錄之錯誤之 ULONG 的可變大小陣列。
傳回值
沒有
言論
NdisWriteErrorLogEntry 配置 I/O 錯誤記錄檔、填入記錄中提供的錯誤資訊，然後將記錄寫入 I/O 錯誤記錄檔。
系統會限制錯誤記錄檔記錄的潛在大小。 針對 Windows 2000 和更新版本，限制會定義為ERROR_LOG_MAXIMUM_SIZE。 NumberOfErrorValues 傳遞至 NdisWriteErrorLogEntry 因此具有系統強制執行的限制，這遠低於 ULONG 的最大值。
實際上，NdisWriteErrorLogEntry 的呼叫端很少 甚至接近 NumberOfErrorValues 的限制，因為使用 Win32 事件查看器提供許多其他NDIS_STATUS_XXX 值並不特別有用。 在可能的機會中記錄 I/O 錯誤對用戶來說並不特別有用，因此迷你埠驅動程式應該只記錄重要的 I/O 錯誤，以協助使用者或系統管理員偵錯 NIC 在特定機器上負責的網路失敗，或驅動程式初始化期間探索到的設定資源衝突。
一般而言，如果迷你埠驅動程式無法初始化 NIC，或無法配置在 NIC 上執行 I/O 作業所需的硬體資源時，MiniportInitializeEx 函式時，會呼叫 NdisWriteErrorLogEntry。 當裝置重設作業因無法復原的硬體錯誤而失敗時，迷你埠驅動程式也可以呼叫 NdisWriteErrorLogEntry。 記錄這類 I/O 錯誤可協助使用者或系統管理員識別設定錯誤的 NIC 或具有失敗硬體元件的 NIC。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式（請參閱 NdisWriteErrorLogEntry （NDIS 5.1）。 支援 NDIS 5.1 驅動程式（請參閱 Windows XP 中的 NdisWriteErrorLogEntry （NDIS 5.1）。 |
| 目標平臺 | 普遍 |
| 標頭 | ndis.h （包括 Ndis.h） |
| 連結庫 | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | Irql_Miscellaneous_Function（ndis） |