Freigeben über


RxLogEventWithAnnotation-Funktion (rxprocs.h)

RxLogEventWithAnnotation eine E/A-Fehlerprotokollstruktur zuordnet, füllt sie mit Informationen aus und schreibt den Eintrag in das E/A-Fehlerprotokoll.

Syntax

void RxLogEventWithAnnotation(
  [in] IN PRDBSS_DEVICE_OBJECT DeviceObject,
       IN ULONG                EventId,
       IN NTSTATUS             Status,
       IN PVOID                DataBuffer,
       IN USHORT               DataBufferLength,
       IN PUNICODE_STRING      Annotation,
  [in] IN ULONG                AnnotationCount
);

Parameter

[in] DeviceObject

Ein Zeiger auf das RDBSS-Geräteobjekt.

EventId

Der Wert, der den E/A-Fehlerprotokollcode angibt, der sich von einem NTSTATUS-Wert unterscheidet, der von einer Routine zurückgegeben wird. Die Werte des gültigen E/A-Fehlerprotokolls werden in der ntiolog.h Headerdatei definiert, die im Microsoft Windows SDK und Visual Studio enthalten ist.

Status

Der Wert, der den Statuscode einer Routine angibt, der einen Fehler angibt.

DataBuffer

Ein Zeiger auf einen Rohdatenpuffer, der der Fehlerprotokollstruktur "E/A" hinzugefügt werden soll.

DataBufferLength

Die Länge des Rohdatenpuffers, der der E/A-Fehlerprotokollstruktur hinzugefügt werden soll.

Annotation

Ein Zeiger auf alle Anmerkungszeichenfolgen, die der E/A-Fehlerprotokollstruktur hinzugefügt werden sollen.

[in] AnnotationCount

Die Anzahl der Anmerkungszeichenfolgen, die der E/A-Fehlerprotokollstruktur hinzugefügt werden sollen.

Rückgabewert

Nichts

Bemerkungen

Ein Netzwerk-Miniumleitungsmodul ruft RxLogEventWithAnnotation auf, um einen E/A-Fehler zu protokollieren.

Die Eingabegröße des E/A-Fehlerprotokolls ist auf eine Länge von 255 Zeichen beschränkt. Wenn also die kombinierte Länge des ID-, RawDataBuffer-und Anmerkungen Parameter sowie die Größe des festen Teils des I/O-Fehlerprotokolleintrags 255 überschreitet, dann RxLogEventWithAnnotation im Hintergrund fehlschlägt und kein I/O-Fehlerprotokolleintrag erstellt wird.

Die RxLogEventWithAnnotation Routine muss Arbeitsspeicher zuweisen, um den E/A-Fehlerprotokolleintrag zu erstellen. Folglich kann RxLogEventWithAnnotation im Hintergrund fehlschlagen, wenn die Speicherzuweisung fehlschlägt.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- rxprocs.h (include Rxprocs.h, Rxstruc.h)
IRQL- <= APC_LEVEL

Siehe auch

RxLogEventDirect-

RxLogEventWithBufferDirect

_RxLog