WdfRequestRetrieveActivityId-Funktion (wdfrequest.h)

[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:

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

Weitere Informationen

WdfRequestSetActivityId