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 |