WdfRequestRetrieveActivityId-Funktion (wdfrequest.h)

Artikel
02/07/2025

[Gilt nur für UMDF]

Die WdfRequestRetrieveActivityId Methode ruft den aktuellen Aktivitätsbezeichner ab, der einer E/A-Anforderung zugeordnet ist.

Syntax

NTSTATUS WdfRequestRetrieveActivityId(
  [in]  WDFREQUEST Request,
  [out] LPGUID     ActivityId
);

Parameter

[in] Request

Ein Handle zu einem Framework-Anforderungsobjekt.

[out] ActivityId

Ein Zeiger auf einen Speicherort zum Speichern der abgerufenen GUID.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt WdfRequestRetrieveActivityId STATUS_SUCCESS zurück. Weitere Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_NOT_FOUND	Der Anforderung ist keine Aktivitäts-ID zugeordnet.

Die Methode gibt möglicherweise andere NTSTATUS-Wertezurück.

Bemerkungen

Vom Kernelmodus reflektierte Anforderungen verfügen nur über einen Aktivitätsbezeichner, wenn der Kernelablaufverfolgungsanbieter aktiviert ist oder wenn der UMDF-Treiber WdfRequestSetActivityId nach erhalt der Anforderung aufgerufen wird. Weitere Informationen zur Ereignisablaufverfolgung für Windows (ETW) finden Sie unter Ereignisablaufverfolgung.

Vom UMDF-Treiber initiierte Anforderungen verfügen nur über einen Aktivitätsbezeichner, wenn der UMDF-Treiber zuvor WdfRequestSetActivityIdaufgerufen wurde.

Das Framework löscht den Aktivitätsbezeichner einer Anforderung nicht, wenn der Treiber WdfRequestReuseaufruft.

Weitere Informationen zu Aktivitätsbezeichnern finden Sie unter Verwenden von Aktivitätsbezeichnern.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8.1
Zielplattform-	Universal
Mindest-UMDF-Version	2.0
Header-	wdfrequest.h (include Wdf.h)
Library	WUDFx02000.lib
DLL-	WUDFx02000.dll
IRQL-	PASSIVE_LEVEL

Siehe auch

WdfRequestSetActivityId

Freigeben über