Funzione RxLogEventDirect (rxprocs.h)

Articolo
02/26/2024

RxLogEventDirect viene chiamato per registrare un errore nel log degli errori di I/O.

È consigliabile utilizzare la macro RXLogEvent o RxLogFailure anziché chiamare direttamente questa routine.

Sintassi

void RxLogEventDirect(
  [in] IN PRDBSS_DEVICE_OBJECT DeviceObject,
  [in] IN PUNICODE_STRING      OriginatorId,
  [in] IN ULONG                EventId,
  [in] IN NTSTATUS             Status,
  [in] IN ULONG                Line
);

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo RDBSS.

[in] OriginatorId

Stringa che indica il chiamante che genera l'errore.

[in] EventId

Valore che indica il valore del 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.

[in] Status

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

[in] Line

Numero di riga nel file del codice sorgente in cui si è verificato questo errore.

Valore restituito

nessuno

Osservazioni

RxLogEventDirect chiama internamente la routine RxLogEventWithAnnotation per creare e scrivere la voce di log.

La dimensione della voce del log degli errori di I/O è limitata a una lunghezza di 255 caratteri. Pertanto, se la lunghezza combinata di OriginatorId e le dimensioni della parte fissa del log degli errori di I/O superano 255, non verrà creata alcuna voce del 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, RxLogEventDirect può avere esito negativo in modo invisibile all'utente se l'allocazione della memoria ha esito negativo.

Requisiti

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

Vedi anche

RxLogEventWithAnnotation

RxLogEventWithBufferDirect

_RxLog

Condividi tramite