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

Функция EtwActivityIdControl создает, запрашивает и задает идентификатор текущего действия.

Синтаксис

NTSTATUS EtwActivityIdControl(
  [in]      ULONG  ControlCode,
  [in, out] LPGUID ActivityId
);

Параметры

[in] ControlCode

Параметр ControlCode может иметь одно из следующих определенных значений.

Значение	Значение
EVENT_ACTIVITY_CTRL_GET_ID	Возвращает идентификатор действия текущего потока в параметре ActivityId .
EVENT_ACTIVITY_CTRL_SET_ID	Задает идентификатор действия текущего потока в значение, указанное в ActivityId. Обратите внимание, что идентификатор ActivityId , который передается в эту функцию, необязательно должен быть идентификатором, созданным EVENT_ACTIVITY_CTRL_CREATE_ID или EVENT_ACTIVITY_CTRL_CREATE_SET_ID кодом элемента управления. Можно использовать любое значение, которое помещается в GUID, включая любое доступное локальное значение, которое будет соответствовать вашему потребностям в идентификаторе определенного типа действия.
EVENT_ACTIVITY_CTRL_CREATE_ID	Создает новый идентификатор и задает для параметра ActivityId значение нового идентификатора.
EVENT_ACTIVITY_CTRL_GET_SET_ID	Задает идентификатор действия текущего потока в значение, указанное в ActivityId, а затем возвращает ActivityId со значением идентификатора действия потока до вызова функции.
EVENT_ACTIVITY_CTRL_CREATE_SET_ID	Копирует идентификатор действия текущего потока. Создает новый идентификатор и задает для идентификатора действия текущего потока новое значение. Возвращает ActivityId со значением идентификатора действия потока перед вызовом функции.

[in, out] ActivityId

Идентификатор, указывающий действие, связанное с событием. Параметр ActivityId предоставляет способ группировки связанных событий и используется для сквозной трассировки.

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

EtwActivityIdControl возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS.

Комментарии

Идентификаторы действий предоставляют метод связывания отдельных событий в общем потоке вычислений. Действие — это рабочий элемент, выполняемый приложением или драйвером. Концепция действия является основным компонентом комплексной трассировки.

Вызывающие функции EtwActivityIdControl должны выполняться на DISPATCH_LEVEL IRQL < , если controlCode не EVENT_ACTIVITY_CTRL_CREATE_ID. В этом случае функцию можно вызвать в любом IRQL.

Используйте функцию EtwActivityIdControlKernel для запроса или задания потоков ядра идентификаторов действий.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe; Ntdll.dll
IRQL	См. раздел "Комментарии"

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

EtwActivityIdControlKernel