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

另請參閱

FltGetActivityIdCallbackData

FltSetActivityIdCallbackData