Funzione RxLogEventWithAnnotation (rxprocs.h)
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 del codice di log degli errori di I/O legali sono definiti nel file di intestazione ntiolog.h incluso in Microsoft Windows SDK e 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 di dati non elaborato 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 dell'ID , RawDataBuffere annotazioni parametri più la dimensione 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 caso di errore dell'allocazione della memoria.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | rxprocs.h (include Rxprocs.h, Rxstruc.h) |
| IRQL | <= APC_LEVEL |