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