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
Zeiger auf die Rückrufdaten, die die Anforderung mit einer zugeordneten Aktivitäts-ID enthalten.
[in/out] PropagateId
Zeiger auf eine vom Aufrufer zugewiesene GUID , die die Aktivitäts-ID für den aktuellen Thread speichert.
[out] OriginalId
Bei der Rückgabe verweist der 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 CallbackData ist keine Aktivitäts-ID zugeordnet. |
| STATUS_SUCCESS | Im GUID-Wert , auf den OriginalId verweist, wurde eine Aktivitäts-ID zurückgegeben. |
Hinweise
Die FltPropagateActivityIdToThread-Routine wird von ablaufverfolgungsfähigen Minifiltern verwendet. Ein Minifilter verwendet diese Routine, um die Aktivitäts-ID eines IRP an einen Workerthread anzufügen, der E/A für die Anforderung verarbeitet.
Ein Minifilter muss IoClearActivityIdThread mit dem Zeiger in OriginalId aufrufen, bevor die Steuerung vom Workerthread zurückgegeben wird, wenn der Aufruf von FltPropagateActivityIdToThread erfolgreich war.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8. |
| Zielplattform | Universell |
| Header | fltkernel.h (fltkernel.h einschließen) |
| Bibliothek | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= DISPATCH_LEVEL |