NdisWriteErrorLogEntry-Funktion (ndis.h)

NdisWriteErrorLogEntry schreibt einen Eintrag in die System-E/A-Fehlerprotokolldatei.

Syntax

VOID NdisWriteErrorLogEntry(
  [in] NDIS_HANDLE     NdisAdapterHandle,
  [in] NDIS_ERROR_CODE ErrorCode,
  [in] ULONG           NumberOfErrorValues,
       ...             
);

Parameter

[in] NdisAdapterHandle

Gibt das Handle an, das die NIC darstellt, die die Ursache für die Protokollierung des E/A-Fehlers darstellt. Dieses Handle ist ein Eingabeparameter für MiniportInitializeEx.

[in] ErrorCode

Gibt den NDIS_ERROR_CODE_XXX--Code an, der den E/A-Fehler am besten als einen der folgenden Werte beschreibt:

NDIS_ERROR_CODE_RESOURCE_CONFLICT

Der Treiber konnte nicht auf eine erforderliche Ressource zugreifen.

NDIS_ERROR_CODE_OUT_OF_RESOURCES

Die Hardware oder der Treiber haben keine Ressourcen mehr.

NDIS_ERROR_CODE_HARDWARE_FAILURE

Der Treiber hat einen Hardwarefehler erkannt.

NDIS_ERROR_CODE_ADAPTER_NOT_FOUND

Der Netzwerkadapter wurde nicht gefunden.

NDIS_ERROR_CODE_INTERRUPT_CONNECT

Fehler bei der Unterbrechungsregistrierung.

NDIS_ERROR_CODE_DRIVER_FAILURE

Ein Treiberfehler ist aufgetreten, der keiner der anderen Fehlerbedingungen entspricht.

NDIS_ERROR_CODE_BAD_VERSION

Der Treiber hat einen Versionskonflikt erkannt.

NDIS_ERROR_CODE_TIMEOUT

Ein Timeout ist abgelaufen.

NDIS_ERROR_CODE_NETWORK_ADDRESS

Eine Netzwerkadresse ist ungültig.

NDIS_ERROR_CODE_UNSUPPORTED_CONFIGURATION

Die angeforderte Treiberkonfiguration wird nicht unterstützt.

NDIS_ERROR_CODE_INVALID_VALUE_FROM_ADAPTER

Die Netzwerkadapterhardware hat einen ungültigen Wert bereitgestellt.

NDIS_ERROR_CODE_MISSING_CONFIGURATION_PARAMETER

In der Registrierung fehlt ein Treiberkonfigurationsparameter.

NDIS_ERROR_CODE_BAD_IO_BASE_ADDRESS

Die E/A-Basisadresse für die Netzwerkadapterhardware ist ungültig.

NDIS_ERROR_CODE_RECEIVE_SPACE_SMALL

Die Menge des verfügbaren Empfangspufferspeichers ist zu klein, um Daten zu empfangen.

NDIS_ERROR_CODE_ADAPTER_DISABLED

Die Netzwerkadapterhardware ist deaktiviert.

[in] NumberOfErrorValues

Gibt die Anzahl der ULONG-Werte an, die diesem Parameter folgen sollen.

...

Gibt ein Array mit variabler Größe von ULONGs an, die dem zu protokollierenden Fehler zugeordnet sind.

Rückgabewert

Nichts

Bemerkungen

NdisWriteErrorLogEntry einen E/A-Fehlerprotokolldatensatz zuordnet, füllt den Datensatz mit den angegebenen Informationen zum Fehler aus und schreibt dann den Datensatz in die E/A-Fehlerprotokolldatei.

Das System begrenzt die potenzielle Größe eines Fehlerprotokolldatensatzes. Für Windows 2000 und höhere Versionen wird der Grenzwert als ERROR_LOG_MAXIMUM_SIZE definiert. Die NumberOfErrorValues an NdisWriteErrorLogEntry übergeben daher einen vom System erzwungenen Grenzwert aufweist, der erheblich kleiner als der maximal mögliche Wert für eine ULONG ist.

In der Praxis sind nur wenige Aufrufer von NdisWriteErrorLogEntry sogar den Grenzwert für NumberOfErrorValues- nähern, da das Bereitstellen vieler zusätzlicher NDIS_STATUS_XXX--Werte nicht besonders hilfreich für den Benutzer oder Systemadministrator ist, der das Fehlerprotokoll später mithilfe der Win32-Ereignisanzeige liest. Das Protokollieren eines E/A-Fehlers bei jeder möglichen Gelegenheit ist für Benutzer nicht besonders hilfreich. Daher sollte ein Miniporttreiber nur wichtige E/A-Fehler protokollieren, die einem Benutzer oder Systemadministrator helfen können, einen Netzwerkfehler zu debuggen, für den die NIC auf einem bestimmten Computer verantwortlich ist, oder ein während der Treiberinitialisierung ermittelter Konfigurationsressourcenkonflikt.

Im Allgemeinen ruft ein Miniporttreiber NdisWriteErrorLogEntry- während der Initialisierung von seiner MiniportInitializeEx--Funktion auf, wenn eine NIC nicht initialisiert werden kann, die sie steuert oder nicht die Hardwareressourcen zuordnen kann, die sie zum Ausführen von E/A-Vorgängen für eine NIC benötigt. Ein Miniporttreiber kann auch NdisWriteErrorLogEntry- aufrufen, wenn ein Gerätezurücksetzungsvorgang aufgrund nicht behebbarer Hardwarefehler fehlschlägt. Die Protokollierung dieser Arten von E/A-Fehlern hilft Benutzern oder Systemadministratoren, eine schlecht konfigurierte NIC oder eine NIC mit fehlerhaften Hardwarekomponenten zu identifizieren.

Anforderungen

Siehe auch

MiniportInitializeEx-

MiniportResetEx-

NdisMSetMiniportAttributes