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 del 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] Line
Número de línea en el 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.
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 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 RxLogEventWithAnnotation debe asignar memoria para crear la entrada de registro de errores de E/S . Por lo tanto, RxLogEventDirect puede producir un error 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 |