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

Статья
02/07/2025

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

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

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

Никакой

Замечания

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

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

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	rxprocs.h (include Rxprocs.h, Rxstruc.h)
IRQL	<= APC_LEVEL

См. также

RxLogEventDirect

RxLogEventWithBufferDirect

_RxLog

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