NdisWriteEventLogEntry-Funktion (ndis.h)
NdisWriteEventLogEntry protokolliert ein Ereignis im Win32-Ereignisprotokoll.
Syntax
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
Zeigen Sie auf das Treiberobjekt des Protokolls, das dieses Ereignis protokolliert.
[in] EventCode
Gibt den NDIS_STATUS_XXX- Code an, der das Ereignis beschreibt.
[in] UniqueEventValue
Identifiziert diese Instanz der Fehlermeldung.
[in] NumStrings
Gibt die Anzahl der Zeiger auf Unicode-Zeichenfolgen in der optionalen StringsList-an. Wenn StringsList-NULL-ist, muss NumStrings null sein.
[in, optional] StringsList
Entweder NULL- oder verweist auf gepufferte Unicode-Zeichenfolgen. Diese Zeichenfolgen, die das Ereignis beschreiben, werden in das Win32-Ereignisprotokoll eingefügt und können mit der Win32-Ereignisanzeige untersucht werden. Jede Zeichenfolge muss eine NUL-beendete Unicode-Zeichenfolge sein.
[in] DataSize
Gibt die Anzahl der Bytes im Puffer für die Binärdaten bei Data an. Wenn DataNULL-ist, muss DataSize null sein.
[in, optional] Data
Entweder NULL- oder verweist auf gepufferte Binärabbilddaten, die für das Verständnis des Ereignisses nützlich sind. Diese Daten können mit der Win32-Ereignisanzeige untersucht werden.
Rückgabewert
NdisWriteEventLogEntry kann einen der folgenden Werte zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
|
Das Ereignis wurde erfolgreich protokolliert. |
|
Die optional bereitgestellten Unicode-Zeichenfolgen und Binärabbilddaten überschreiten die maximal zulässige Größe (MAX_EVENT_LOG_DATA_SIZE). |
|
NDIS konnte den Speicher für den E/A-Fehlerprotokolldatensatz nicht zuordnen. |
Bemerkungen
NdisWriteEventLogEntry einen E/A-Fehlerprotokolldatensatz zuordnet, füllt den Datensatz mit den bereitgestellten Informationen zum Ereignis aus und schreibt dann den Datensatz in die E/A-Fehlerprotokolldatei. Ein Benutzer kann das protokollierte Ereignis anzeigen, einschließlich einer optionalen Beschreibung des Ereignisses und/oder optionaler Binärabbilddaten, mit der Win32-Ereignisanzeige.
Der NT-Fehlerprotokollierungsthread verwendet alle Zeichenfolgen, die im optionalen StringsList- bereitgestellt werden, um Nachrichten in das Win32-Ereignisprotokoll einzufügen. Jede Zeichenfolge muss eine NUL-beendete Unicode-Zeichenfolge sein. Der E/A-Manager geht davon aus, dass die ursprüngliche Zeichenfolge entweder der Name des Treibers ist, der den Fehler meldet, oder den Namen des Geräts, das den Fehler verursacht hat.
Die vom Aufrufer bereitgestellten Unicode-Zeichenfolgen sollten aus der Registrierung gelesen werden oder sprachunabhängig sein (d. a. die Zeichenfolgen sollten in einer beliebigen Sprache identisch sein , z. B. könnte die Zeichenfolge ein Dateiname sein).
Vom Aufrufer bereitgestellte Speicherabbilddaten können binärdaten (z. B. Registerwerte) sein, die beim Verständnis des Ereignisses nützlich sind. Der Aufrufer muss die Binärdaten nicht auffüllen. Falls erforderlich, NdisWriteEventLogEntry pads die Binärabbilddaten, sodass die endgültige Datengröße ein vielfaches Integral von Sizeof(ULONG) ist.
Das System beschränkt die Gesamtgröße der optionalen Daten, die an NdisWriteEventLogEntry-bereitgestellt werden. Die kombinierte Größe der Zeichenfolgenliste und das (möglicherweise aufgefüllte) binäre Dump muss kleiner oder gleich MAX_EVENT_LOG_DATA_SIZE sein.
NdisWriteEventLogEntry wird nur von Protokolltreibern aufgerufen. Miniport-Treiber sollten NdisWriteErrorLogEntry- aufrufen, um Ereignisse und Fehler zu protokollieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisWriteEventLogEntry (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisWriteEventLogEntry (NDIS 5.1)) in Windows XP. |
| Zielplattform- | Universal |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis) |