Функция RxLogEventWithAnnotation (rxprocs.h)

Статья
02/26/2024

RxLogEventWithAnnotation выделяет структуру журнала ошибок ввода-вывода, заполняет ее информацией и записывает запись в журнал ошибок ввода-вывода.

Синтаксис

void RxLogEventWithAnnotation(
  [in] IN PRDBSS_DEVICE_OBJECT DeviceObject,
       IN ULONG                EventId,
       IN NTSTATUS             Status,
       IN PVOID                DataBuffer,
       IN USHORT               DataBufferLength,
       IN PUNICODE_STRING      Annotation,
  [in] IN ULONG                AnnotationCount
);

Параметры

[in] DeviceObject

Указатель на объект устройства RDBSS.

EventId

Значение, указывающее код журнала ошибок ввода-вывода, который отличается от значения NTSTATUS, возвращаемого подпрограммой. Допустимые значения кода журнала ошибок ввода-вывода определяются в файле заголовка ntiolog.h, который входит в состав Microsoft Windows SDK и Visual Studio.

Status

Значение, указывающее код состояния подпрограммы, указывающий на сбой.

DataBuffer

Указатель на буфер необработанных данных, добавляемый в структуру журнала ошибок ввода-вывода.

DataBufferLength

Длина буфера необработанных данных, добавляемого в структуру журнала ошибок ввода-вывода.

Annotation

Указатель на любые строки заметок для добавления в структуру журнала ошибок ввода-вывода.

[in] AnnotationCount

Количество строк заметок, добавляемых в структуру журнала ошибок ввода-вывода.

Возвращаемое значение

None

Remarks

Сетевой мини-перенаправление вызовет RxLogEventWithAnnotation для регистрации ошибки ввода-вывода.

Размер записи журнала ошибок ввода-вывода ограничен длиной 255 символов. Таким образом, если совокупная длина параметров Id, RawDataBuffer и Annotations плюс размер фиксированной части записи ошибок ввода-вывода превышает 255, RxLogEventWithAnnotation будет автоматически завершатся сбоем и запись журнала ошибок ввода-вывода не будет создана.

Подпрограмме RxLogEventWithAnnotation необходимо выделить память, чтобы создать запись журнала ошибок ввода-вывода . Следовательно, при сбое выделения памяти RxLogEventWithAnnotation может завершиться автоматическим сбоем.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	rxprocs.h (включая Rxprocs.h, Rxstruc.h)
IRQL	<= APC_LEVEL

См. также раздел

RxLogEventDirect

RxLogEventWithBufferDirect

_RxLog

Поделиться через