WdfRequestRetrieveActivityId-Funktion (wdfrequest.h)

  • Artikel

[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 für ein Frameworkanforderungsobjekt.

[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-Werte zurück.

Hinweise

Anforderungen, die aus dem Kernelmodus reflektiert werden, verfügen nur dann über einen Aktivitätsbezeichner, wenn der Kernelablaufverfolgungsanbieter aktiviert ist oder wenn der UMDF-Treiber WdfRequestSetActivityId nach dem Empfang der Anforderung genannt wird. Weitere Informationen zur Ereignisablaufverfolgung für Windows (ETW) finden Sie unter Ereignisablaufverfolgung.

Anforderungen, die vom UMDF-Treiber initiiert werden, verfügen nur dann über einen Aktivitätsbezeichner, wenn der UMDF-Treiber zuvor WdfRequestSetActivityId genannt hat.

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

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1
Zielplattform Universell
UMDF-Mindestversion 2.0
Kopfzeile wdfrequest.h (einschließen von Wdf.h)
Bibliothek WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

Weitere Informationen

WdfRequestSetActivityId