IWDFIoRequest3::SetActivityId-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 SetActivityId Methode ordnet eine Aktivitäts-ID einer E/A-Anforderung zu.
Syntax
void SetActivityId(
[in] LPGUID ActivityId
);
Parameter
[in] ActivityId
Ein Zeiger auf die GUID der Aktivitäts-ID, die in der E/A-Anforderung gespeichert werden soll.
Rückgabewert
Nichts
Bemerkungen
Durch Aufrufen SetActivityId- wird keine Zuordnung zu einem zuvor vorhandenen Aktivitätsbezeichner festgelegt. Wenn der Treiber SetActivityIdaufruft, wird jeder vorhandene Aktivitätsbezeichner überschrieben.
Rufen Sie zum Festlegen einer Zuordnung den vorhandenen Bezeichner ab, indem Sie RetrieveActivityId aufrufen und dann den vorhandenen Bezeichner dem neuen zuordnen, indem Sie EventWriteTransferaufrufen.
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 WdfRequestSetActivityId.
Beispiele
Ein Codebeispiel, das SetActivityId-verwendet, finden Sie unter RetrieveActivityId.
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 |