Función RxLogEventWithBufferDirect (rxprocs.h)

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

Ninguno

Observaciones

RxLogEventDirect llama internamente a la rutina de RxLogEventWithAnnotation para crear y escribir la entrada de registro que pasa los parámetros Status de y LineNumber como parámetro Annotations para 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 del EventId, dataBuffery parámetros parámetros 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, rxLogEventWithBufferDirect puede producir un error silencioso si se produce un error en la asignación de memoria.

Requisitos

Consulte también

RxLogEventDirect

RxLogEventWithAnnotation

_RxLog