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

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

Siehe auch

WdfRequestSetActivityId