Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

FltPropagateActivityIdToThread routine

The FltPropagateActivityIdToThread routine associates the activity ID from the IRP in the minifilter's callback data with the current thread.

Syntax


NTSTATUS FltPropagateActivityIdToThread(
  _In_    PFLT_CALLBACK_DATA CallbackData,
  _Inout_ LPGUID             PropagatedId,
  _Out_   LPGUID             *OriginalId
);

Parameters

CallbackData [in]

A pointer to the callback data containing the request with an associated activity ID.

PropagatedId [in, out]

A pointer to a caller allocated GUID which stores the activity ID for the current thread.

OriginalId [out]

On return, the GUID pointer referenced by OriginalId points to the activity ID that was previously set for the thread.

Return value

FltPropagateActivityIdToThread returns one of the following NTSTATUS values.

Return codeDescription
STATUS_NOT_SUPPORTED

The callback data does not contain a request for an IRP operation.

STATUS_NOT_FOUND

No activity ID is associated with the request in CallbackData.

STATUS_SUCCESS

An activity ID was returned in the GUID value pointed to by Guid.

 

Remarks

The FltPropagateActivityIdToThread routine is used by trace aware minifilters. A minifilter will use this routine to attach the activity ID from an IRP to a worker thread processing I/O for the request. A minifilter must call IoClearActivityIdThread with the pointer in OriginalId before returning control from the worker thread if the call to FltPropagateActivityIdToThread was successful.

Requirements

Target platform

Universal

Version

Available starting with Windows 8.

Header

Fltkernel.h (include Fltkernel.h)

Library

FltMgr.lib

IRQL

<= DISPATCH_LEVEL

See also

FltGetActivityIdCallbackData
FltSetActivityIdCallbackData

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft