Función RxLogEventWithBufferDirect (rxprocs.h)

Artículo
02/26/2024

RxLogEventWithBufferDirect 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 RxLogEventWithBufferDirect(
       IN PVOID           DeviceOrDriverObject,
  [in] IN PUNICODE_STRING OriginatorId,
  [in] IN ULONG           EventId,
  [in] IN NTSTATUS        Status,
  [in] IN PVOID           DataBuffer,
  [in] IN USHORT          DataBufferLength,
  [in] IN ULONG           LineNumber
);

Parámetros

DeviceOrDriverObject

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 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.

[in] Status

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

[in] DataBuffer

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

[in] DataBufferLength

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

[in] LineNumber

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

Valor devuelto

None

Observaciones

RxLogEventDirect llama internamente a la rutina RxLogEventWithAnnotation para crear y escribir la entrada de registro pasando los parámetros Status y LineNumber como parámetro Annotations a RxLogEventWithAnnotation.

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 EventId, DataBuffer y Annotations más el tamaño de la parte fija de la entrada del registro de errores de E/S supera los 255, no se creará ninguna entrada de registro de errores de E/S.

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