IWDFIoRequest3::RetrieveActivityId-Methode (wudfddi.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

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

Syntax

HRESULT RetrieveActivityId(
  [out] LPGUID ActivityId
);

Parameter

[out] ActivityId

Ein Zeiger auf einen Speicherort zum Speichern der abgerufenen GUID.

Rückgabewert

RetrieveActivityId gibt S_OK zurück, wenn der Aufruf erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	Der Anforderung ist keine Aktivitäts-ID zugeordnet.

Hinweise

Anforderungen, die aus dem Kernelmodus reflektiert werden, haben nur dann einen Aktivitätsbezeichner, wenn der Kernelablaufverfolgungsanbieter aktiviert ist oder wenn der UMDF-Treiber IWDFIoRequest3::SetActivityId 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 über einen Aktivitätsbezeichner, der nur verfügbar ist, wenn der UMDF-Treiber zuvor IWDFIoRequest3::SetActivityId genannt wurde.

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

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

Das UMDF 2-Äquivalent dieser Methode ist WdfRequestRetrieveActivityId.

Beispiele

Das folgende Codebeispiel zeigt, dass ein Treiber einen Aktivitätsbezeichner aus einer Anforderung abrufen und dann verwenden kann, um den Aktivitätsbezeichner für eine andere Anforderung festzulegen.

hrQI = pWdfRequest->QueryInterface(IID_PPV_ARGS(&pOriginalRequest3));
ASSERT(SUCCEEDED(hrQI));

hrQI = pNewRequest->QueryInterface(IID_PPV_ARGS(&pNewRequest3));
ASSERT(SUCCEEDED(hrQI));

//
// Obtain activity id from original request and set in the new one
//

pOriginalRequest3->RetrieveActivityId(&activityId);
pNewRequest3->SetActivityId(&activityId);

pOriginalRequest3->Release();
pNewRequest3->Release();

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.11
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Weitere Informationen

IWDFIoRequest3

IWDFIoRequest3::SetActivityId