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 |