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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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. |
Bemerkungen
Anforderungen aus dem Kernelmodus sind nur verfügbar, wenn der Kernelablaufverfolgungsanbieter aktiviert ist oder wenn der UMDF-Treiber IWDFIoRequest3::SetActivityId 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 IWDFIoRequest3::SetActivityIdaufgerufen wurde.
Das Framework löscht den Aktivitätsbezeichner einer Anforderung nicht, wenn der Treiber IWdfIoRequest2::Reuseaufruft.
Weitere Informationen zu Aktivitätsbezeichnern finden Sie unter Verwenden von Aktivitätsbezeichnern.
Die UMDF 2-Entsprechung dieser Methode ist WdfRequestRetrieveActivityId.
Beispiele
Das folgende Codebeispiel zeigt, dass ein Treiber einen Aktivitätsbezeichner aus einer Anforderung abrufen kann und ihn 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 |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.11 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |