Функция TraceSetInformation (evntrace.h)

Функция TraceSetInformation настраивает параметры сеанса трассировки событий.

Синтаксис

ULONG WMIAPI TraceSetInformation(
       CONTROLTRACE_ID  TraceId,
  [in] TRACE_INFO_CLASS InformationClass,
  [in] PVOID            TraceInformation,
  [in] ULONG            InformationLength
);

Параметры

TraceId

[in] InformationClass

Класс сведений для включения или отключения. Сведения о захвате класса включаются в расширенный раздел данных события. Список доступных классов информации см. в перечислении TRACE_QUERY_INFO_CLASS .

[in] TraceInformation

Указатель на определенные данные класса информации. Класс сведений определяет содержимое этого параметра.

[in] InformationLength

Размер данных в байтах в буфере TraceInformation .

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

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

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

• ERROR_BAD_LENGTH

  Программа выдала команду, но длина команды неправильная. Эта ошибка возвращается, если параметр InformationLength меньше минимального размера.

• ERROR_INVALID_PARAMETER

  Недопустимый параметр.

• ERROR_NOT_SUPPORTED

  Запрос не поддерживается.

• Другое

  Используйте FormatMessage , чтобы получить строку сообщения для возвращаемой ошибки.

Замечания

Вызовите эту функцию после вызова StartTrace.

Если параметр InformationClass имеет значение TraceStackTracingInfo, вызов этой функции включает трассировку стека указанных событий ядра. Последующие вызовы этой функции перезаписывают предыдущий список событий ядра, для которых включена трассировка стека. Чтобы отключить трассировку стека, вызовите эту функцию с параметром InformationClass , равным TraceStackTracingInfo и InformationLength , равным 0.

В расширенный раздел данных события будет включен стек вызовов. Класс MOF StackWalk_Event определяет макет расширенных данных.

Как правило, на 64-разрядных компьютерах невозможно записать стек ядра в определенных контекстах, если ошибки страницы не разрешены. Чтобы включить переход к стеку ядра в x64, задайте DisablePagingExecutive для реестра управления памятью значение 1. Значение DisablePagingExecutive реестра находится под следующим разделом реестра: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management Это необходимо сделать только для временных целей диагностики, так как это увеличивает использование памяти системы.

Требования

См. также

TRACE_QUERY_INFO_CLASS

TraceQueryInformation