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 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.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | rxprocs.h (include Rxprocs.h, Rxstruc.h) |
| IRQL | <= APC_LEVEL |