Share via

Функция FltPropagateActivityIdToThread (fltkernel.h)

  • Статья

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

Синтаксис

NTSTATUS FLTAPI FltPropagateActivityIdToThread(
  [in]     PFLT_CALLBACK_DATA CallbackData,
  [in/out] LPGUID             PropagateId,
  [out]    LPCGUID            *OriginalId
);

Параметры

[in] CallbackData

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

[in/out] PropagateId

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

[out] OriginalId

При возврате указатель GUID , на который ссылается OriginalId , указывает на идентификатор действия, который был ранее задан для потока.

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

FltPropagateActivityIdToThread возвращает одно из следующих значений NTSTATUS .

Код возврата Описание
STATUS_NOT_SUPPORTED Данные обратного вызова не содержат запроса для операции IRP.
STATUS_NOT_FOUND Идентификатор действия не связан с запросом в CallbackData.
STATUS_SUCCESS Идентификатор действия был возвращен в значении GUID , на который указывает OriginalId.

Комментарии

Подпрограмма FltPropagateActivityIdToThread используется минифильтрами с поддержкой трассировки. Минифильтр использует эту подпрограмму для присоединения идентификатора действия из IRP к рабочему потоку, обрабатывающем ввод-вывод для запроса.

Минифильтр должен вызвать IoClearActivityIdThread с указателем в OriginalId , прежде чем возвращать управление из рабочего потока, если вызов FltPropagateActivityIdToThread был успешным.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 8.
Целевая платформа Универсальное
Верхняя часть fltkernel.h (включая Fltkernel.h)
Библиотека FltMgr.lib
DLL Fltmgr.sys
IRQL <= DISPATCH_LEVEL

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

FltGetActivityIdCallbackData

FltSetActivityIdCallbackData