Функция 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 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 (include Fltkernel.h)
библиотеки FltMgr.lib
DLL Fltmgr.sys
IRQL <= DISPATCH_LEVEL

См. также

FltGetActivityIdCallbackData

FltSetActivityIdCallbackData

  • Last updated on