Funzione RxLogEventWithAnnotation (rxprocs.h)

  • Articolo

RxLogEventWithAnnotation alloca una struttura del log degli errori di I/O, la inserisce in informazioni e scrive la voce nel log degli errori di I/O.

Sintassi

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
);

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo RDBSS.

EventId

Valore che indica il codice del log degli errori di I/O diverso da un valore NTSTATUS restituito da una routine. I valori legali del codice del log degli errori di I/O sono definiti nel file di intestazione ntiolog.h incluso nel Microsoft Windows SDK e in Visual Studio.

Status

Valore che indica il codice di stato di una routine che indica un errore.

DataBuffer

Puntatore a un buffer di dati non elaborato da aggiungere alla struttura del log degli errori di I/O.

DataBufferLength

Lunghezza del buffer dei dati non elaborati da aggiungere alla struttura del log degli errori di I/O.

Annotation

Puntatore a qualsiasi stringa di annotazione da aggiungere alla struttura del log degli errori di I/O.

[in] AnnotationCount

Conteggio del numero di stringhe di annotazione da aggiungere alla struttura del log degli errori di I/O.

Valore restituito

nessuno

Osservazioni

Un mini-redirector di rete chiamerebbe RxLogEventWithAnnotation per registrare un errore di I/O.

La dimensione della voce del log degli errori di I/O è limitata a una lunghezza di 255 caratteri. Pertanto, se la lunghezza combinata dei parametri Id, RawDataBuffer e Annotations più le dimensioni della parte fissa della voce del log degli errori di I/O supera 255, RxLogEventWithAnnotation avrà esito negativo e non verrà creata alcuna voce di log degli errori di I/O.

La routine RxLogEventWithAnnotation deve allocare memoria per creare la voce del log degli errori di I/O . Di conseguenza, RxLogEventWithAnnotation può avere esito negativo in modo invisibile all'utente se l'allocazione della memoria non riesce.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione rxprocs.h (include Rxprocs.h, Rxstruc.h)
IRQL <= APC_LEVEL

Vedi anche

RxLogEventDirect

RxLogEventWithBufferDirect

_RxLog