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

Статья
02/07/2025

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

Синтаксис

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
);

Параметры

DeviceOrDriverObject

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

[in] OriginatorId

Строка, указывающая вызывающий объект, создающий ошибку.

[in] EventId

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

[in] Status

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

[in] DataBuffer

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

[in] DataBufferLength

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

[in] LineNumber

Номер строки в файле исходного кода, в котором произошел сбой.

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

Никакой

Замечания

RxLogEventDirect внутренне вызывает подпрограмму RxLogEventWithAnnot ation для создания и записи записи журнала, передавая состояния и параметры LineNumber в качестве параметра заметки для RxLogEventWithAnnotation.

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

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

Требования

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

См. также

RxLogEventDirect

RxLogEventWithAnnotation

_RxLog

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