Función RxLogEventDirect (rxprocs.h)

se llama a rxLogEventDirect para registrar un error en el registro de errores de E/S.

Se recomienda usar la macro RXLogEvent o la macro RxLogFailure en lugar de llamar directamente a esta rutina.

Sintaxis

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

Parámetros

[in] DeviceObject

Puntero al objeto de dispositivo RDBSS.

[in] OriginatorId

Cadena que indica el autor de la llamada que genera el error.

[in] EventId

Valor que indica el valor de código de registro de errores de E/S que es diferente de un valor NTSTATUS devuelto por una rutina. Los valores de código de registro de errores de E/S legales se definen en el archivo de encabezado de ntiolog.h incluido con Microsoft Windows SDK y Visual Studio.

[in] Status

Valor que indica el código de estado de una rutina que indica un error.

[in] Line

Número de línea del archivo de código fuente donde se produjo este error.

Valor devuelto

Ninguno

Observaciones

RxLogEventDirect llama internamente a la rutina de rxLogEventWithAnnotation para crear y escribir la entrada de registro.

El tamaño de entrada del registro de errores de E/S está limitado a una longitud de 255 caracteres. Por lo tanto, si la longitud combinada del OriginatorId más el tamaño de la parte fija del registro de errores de E/S supera los 255, no se creará ninguna entrada de registro de errores de E/S.

La rutina de RxLogEventWithAnnot ation debe asignar memoria para crear la entrada de registro de errores de E/S . Por lo tanto, RxLogEventDirect puede producir un error en modo silencioso si se produce un error en la asignación de memoria.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	rxprocs.h (incluya Rxprocs.h, Rxstruc.h)
irQL	<= APC_LEVEL

Consulte también

RxLogEventWithAnnotation

rxLogEventWithBufferDirect

_RxLog