Función RxLogEventWithAnnotation (rxprocs.h)

RxLogEventWithAnnotation asigna una estructura de registro de errores de E/S, la rellena con información y escribe la entrada en el registro de errores de E/S.

Sintaxis

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

Parámetros

[in] DeviceObject

Puntero al objeto de dispositivo RDBSS.

EventId

Valor que indica el 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 ntiolog.h incluido con el Microsoft Windows SDK y Visual Studio.

Status

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

DataBuffer

Puntero a un búfer de datos sin procesar que se va a agregar a la estructura del registro de errores de E/S.

DataBufferLength

Longitud del búfer de datos sin procesar que se va a agregar a la estructura del registro de errores de E/S.

Annotation

Puntero a cualquier cadena de anotación que se va a agregar a la estructura del registro de errores de E/S.

[in] AnnotationCount

Recuento del número de cadenas de anotación que se van a agregar a la estructura del registro de errores de E/S.

Valor devuelto

None

Observaciones

Un minidirector de red llamaría a RxLogEventWithAnnotation para registrar un error de E/S.

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 de los parámetros Id, RawDataBuffer y Annotations más el tamaño de la parte fija de la entrada del registro de errores de E/S supera los 255, rxLogEventWithAnnotation producirá un error silencioso y no se creará ninguna entrada de registro de errores de E/S.

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

Requisitos

Consulte también

RxLogEventDirect

RxLogEventWithBufferDirect

_RxLog