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 指標，該 GUID 會儲存目前線程的活動識別碼。
[out] OriginalId
傳回時，OriginalId 所參考的 GUID 指標會指向先前為線程設定的活動識別碼。
傳回值
FltPropagateActivityIdToThread 會傳回下列其中一個 NTSTATUS 值。
| 傳回碼 | Description |
|---|---|
| STATUS_NOT_SUPPORTED | 回呼數據不包含 IRP 作業的要求。 |
| STATUS_NOT_FOUND | CallbackData 中沒有與要求相關聯的活動標識碼。 |
| STATUS_SUCCESS | 活動標識碼是在 OriginalId 所指向的 GUID 值中傳回。 |
備註
FltPropagateActivityIdToThread 例程是由追蹤感知迷你篩選程式使用。 迷你篩選會使用此例程，將活動標識元從 IRP 附加至處理要求的背景工作線程處理 I/O。
如果呼叫 FltPropagateActivityIdToThread 成功，迷你篩選必須先使用 OriginalId 中的指標呼叫 IoClearActivityIdThread，再從背景工作線程傳回控件。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8 開始提供。 |
| 目標平台 | Universal |
| 標頭 | fltkernel.h (包含 Fltkernel.h) |
| 程式庫 | FltMgr.lib |
| Dll | Fltmgr.sys |
| IRQL | <= DISPATCH_LEVEL |