Rutinas y macros de registro

RDBSS proporciona una serie de rutinas para el registro. Estas instalaciones de registro siempre están presentes. Cuando se define la macro RDBSSLOG, se habilita una generación de las llamadas de registro en compilaciones activadas. Cuando se establece NO_RDBSSLOG, las llamadas de registro se deshabilitan.

Las rutinas de registro crean registros almacenados en un búfer circular. Cada registro está limitado en cualquier lado por un descriptor de registro. Este descriptor de registro tiene cuatro bytes de longitud.

En la tabla siguiente se incluyen rutinas de registro.

Rutina	Descripción
RxLogEventDirect	Se llama a esta rutina para registrar un error en el registro de errores de E/S. Se recomienda usar la macro RxLogFailure o RxLogEvent en lugar de llamar directamente a esta rutina.
RxLogEventWithAnnotation	Esta rutina asigna un registro de errores de E/S, rellena el registro de registro y escribe este registro en el registro de errores de E/S.
RxLogEventWithBufferDirect	Esta rutina asigna un registro de errores de E/S, rellena el registro de registro y escribe este registro en el registro de errores de E/S. Esta rutina codifica el número de línea y el estado en el búfer de datos sin procesar almacenado en el registro de errores de E/S. Se recomienda usar la macro RxLogFailureWithBuffer en lugar de llamar directamente a esta rutina.
_RxLog	Esta rutina toma una cadena de formato y un número variable de parámetros y da formato a una cadena de salida para la grabación como entrada del registro de errores de E/S si el registro está habilitado. Se recomienda usar la macro RxLog en lugar de llamar directamente a esta rutina. Esta rutina solo está disponible en compilaciones comprobadas de RDBSS en Windows Server 2003, Windows XP y Windows 2000.

Las macros siguientes se definen en los archivos de encabezado rxlog.h y rxprocs.h que llaman a las rutinas enumeradas en la tabla anterior. Estas macros se usan normalmente en lugar de llamar directamente a estas rutinas.

Macro	Descripción
RxLog(Args)	En las compilaciones activadas, esta macro llama a la rutina _RxLog . En las compilaciones comerciales, esta macro no hace nada. Tenga en cuenta que los argumentos de RxLog se deben incluir con un par de paréntesis adicional para habilitar la traducción en una llamada nula al desactivar el registro.
RxLogEvent (_DeviceObject, _OriginatorId, _EventId, _Status)	Esta macro llama a la rutina RxLogEventDirect .
RxLogFailure (_DeviceObject, _OriginatorId, _EventId, _Status)	Esta macro llama a la rutina RxLogEventDirect .
RxLogFailureWithBuffer (_DeviceObject, _OriginatorId, _EventId, _Status, _Buffer, _Length)	Esta macro llama a la rutina RxLogEventWithBufferDirect .
RxLogRetail(Args)	En las compilaciones activadas, esta macro llama a la rutina _RxLog . En las compilaciones comerciales, esta macro no hace nada. Tenga en cuenta que los argumentos de RxLogRetail se deben incluir con un par de paréntesis adicional para habilitar la traducción en una llamada nula cuando se debe desactivar el registro.