FltPropagateActivityIdToThread 函数 (fltkernel.h)

  • 项目

FltPropagateActivityIdToThread 例程将微筛选器回调数据中的 IRP 中的活动 ID 与当前线程相关联。

语法

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

参数

[in] CallbackData

指向包含具有关联活动 ID 的请求的回调数据的指针。

[in/out] PropagateId

指向调用方分配的 GUID 的指针，该 GUID 存储当前线程的活动 ID。

[out] OriginalId

返回时，OriginalId 引用的 GUID 指针指向先前为线程设置的活动 ID。

返回值

FltPropagateActivityIdToThread 返回以下 NTSTATUS 值之一。

返回代码 说明
STATUS_NOT_SUPPORTED 回调数据不包含对 IRP 操作的请求。
STATUS_NOT_FOUND 没有活动 ID 与 CallbackData 中的请求相关联。
STATUS_SUCCESS 在 OriginalId 指向的 GUID 值中返回了活动 ID。

注解

跟踪感知微筛选器使用 FltPropagateActivityIdToThread 例程。 微筛选器使用此例程将活动 ID 从 IRP 附加到处理请求 I/O 的工作线程。

如果对 FltPropagateActivityIdToThread 的调用成功，则微筛选器必须使用 OriginalId 中的指针调用 IoClearActivityIdThread，然后才能从工作线程返回控件。

要求

要求 值
最低受支持的客户端 从Windows 8开始可用。
目标平台 通用
标头 fltkernel.h (包括 Fltkernel.h)
Library FltMgr.lib
DLL Fltmgr.sys
IRQL <= DISPATCH_LEVEL

另请参阅

FltGetActivityIdCallbackData

FltSetActivityIdCallbackData