FltPropagateActivityIdToThread-Funktion (fltkernel.h)
Die FltPropagateActivityIdToThread Routine ordnet die Aktivitäts-ID aus dem IRP in den Rückrufdaten des Minifilters dem aktuellen Thread zu.
Syntax
NTSTATUS FLTAPI FltPropagateActivityIdToThread(
[in] PFLT_CALLBACK_DATA CallbackData,
[in/out] LPGUID PropagateId,
[out] LPCGUID *OriginalId
);
Parameter
[in] CallbackData
Zeigen Sie auf die Rückrufdaten, die die Anforderung mit einer zugeordneten Aktivitäts-ID enthalten.
[in/out] PropagateId
Zeiger auf einen Aufrufer, der GUID zugewiesen, die die Aktivitäts-ID für den aktuellen Thread speichert.
[out] OriginalId
Beim Zurückgeben verweist die GUID Zeiger, auf den OriginalId verweist auf die Aktivitäts-ID, die zuvor für den Thread festgelegt wurde.
Rückgabewert
FltPropagateActivityIdToThread gibt einen der folgenden NTSTATUS- Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_NOT_SUPPORTED | Die Rückrufdaten enthalten keine Anforderung für einen IRP-Vorgang. |
| STATUS_NOT_FOUND | Der Anforderung in CallbackDataist keine Aktivitäts-ID zugeordnet. |
| STATUS_SUCCESS | Eine Aktivitäts-ID wurde im GUID- Wert zurückgegeben, auf den OriginalId-verweist. |
Bemerkungen
Die FltPropagateActivityIdToThread Routine wird von ablaufverfolgungsfähigen Minifiltern verwendet. Ein Minifilter verwendet diese Routine, um die Aktivitäts-ID von einem IRP an eine Arbeitsthreadverarbeitung für die Anforderung anzufügen.
Ein Minifilter muss IoClearActivityIdThread- mit dem Zeiger in OriginalId- aufrufen, bevor die Steuerung aus dem Arbeitsthread zurückgegeben wird, wenn der Aufruf von FltPropagateActivityIdToThread erfolgreich war.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8. |
| Zielplattform- | Universal |
| Header- | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| DLL- | Fltmgr.sys |
| IRQL- | <= DISPATCH_LEVEL |