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

Функция 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 должны выполняться в IRQL < DISPATCH_LEVEL, если ControlCodeEVENT_ACTIVITY_CTRL_CREATE_ID, в этом случае функция может вызываться в любом IRQL.

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

Требования

Требование Ценность
целевая платформа Всеобщий
заголовка wdm.h (include Wdm.h, Ntddk.h)
библиотеки NtosKrnl.lib
DLL NtosKrnl.exe; Ntdll.dll
IRQL См. раздел "Комментарии"

См. также

EtwActivityIdControlKernel