Функция EtwSetInformation (wdm.h)

  • Статья

EtwSetInformation предоставляет специальные сведения для изменения регистрации поставщика ETW в режиме ядра. Функция EtwSetInformation является эквивалентом функции EventSetInformation в режиме ядра.

Синтаксис

NTSTATUS EtwSetInformation(
  [in]           REGHANDLE        RegHandle,
  [in]           EVENT_INFO_CLASS InformationClass,
  [in, optional] PVOID            EventInformation,
  [in]           ULONG            InformationLength
);

Параметры

[in] RegHandle

Дескриптор регистрации поставщика трассировки событий Windows для изменения. Дескриптор регистрации возвращается EtwRegister.

[in] InformationClass

Тип (EVENT_INFO_CLASS) операции, выполняемой с объектом регистрации.

[in, optional] EventInformation

Входной буфер.

[in] InformationLength

Размер входного буфера.

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

Если функция выполняется успешно, возвращаемое значение будет STATUS_SUCCESS.

Код возврата Описание
STATUS_INVALID_HANDLE Эта ошибка возвращается, если параметр RegHandle не является допустимым дескриптором регистрации.
STATUS_INVALID_PARAMETER Один или несколько параметров недопустимы.
STATUS_INVALID_DEVICE_REQUEST Запрос не поддерживается.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 10 и более поздних версиях Windows.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h)
Библиотека NtosKrnl.lib
IRQL PASSIVE_LEVEL

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

EventSetInformation

EVENT_INFO_CLASS