FltSetActivityIdCallbackData-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltSetActivityIdCallbackData Routine legt die Aktivitäts-ID für ein IRP in den Rückrufdaten eines Minifilters fest.

Syntax

NTSTATUS FLTAPI FltSetActivityIdCallbackData(
  [in, out]      PFLT_CALLBACK_DATA CallbackData,
  [in, optional] LPCGUID            Guid
);

Parameter

[in, out] CallbackData

Ein Zeiger auf die Rückrufdaten, die die Anforderung mit einer zugeordneten Aktivitäts-ID enthalten.

[in, optional] Guid

Ein optionaler Zeiger auf die GUID Struktur, die die Aktivitäts-ID empfängt. Wenn Guid-NULL-ist, versucht das System, eine ETW-Aktivitäts-ID für die Anforderung zuzuweisen.

Rückgabewert

FltSetActivityIdCallbackData 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. -oder- Die GUID-, auf die durch Guid verwiesen wurde, wurde nicht bereitgestellt, und es ist keine ETW-Aktivitäts-ID oder der Vorgang verfügbar.
STATUS_NOT_FOUND	Der Anforderung in CallbackDataist keine Aktivitäts-ID zugeordnet.
STATUS_SUCCESS	Eine Aktivitäts-ID, auf die Guid verweist, wurde für das IRP in CallbackData-festgelegt.

Rückgabecode

Beschreibung

STATUS_NOT_SUPPORTED

Die Rückrufdaten enthalten keine Anforderung für einen IRP-Vorgang.

-oder-

Die GUID-, auf die durch Guid verwiesen wurde, wurde nicht bereitgestellt, und es ist keine ETW-Aktivitäts-ID oder der Vorgang verfügbar.

STATUS_NOT_FOUND

Der Anforderung in CallbackDataist keine Aktivitäts-ID zugeordnet.

STATUS_SUCCESS

Eine Aktivitäts-ID, auf die Guid verweist, wurde für das IRP in CallbackData-festgelegt.

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

Siehe auch

FltGetActivityIdCallbackData-

FltPropagateActivityIdToThread

Freigeben über