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. 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 SetActivityId-Methode ordnet einer E/A-Anforderung einen Aktivitätsbezeichner zu.
Syntax
void SetActivityId(
[in] LPGUID ActivityId
);
Parameter
[in] ActivityId
Ein Zeiger auf die Aktivitätsbezeichner-GUID, die in der E/A-Anforderung gespeichert werden soll.
Rückgabewert
Keine
Bemerkungen
Durch aufrufen von SetActivityId wird keine Zuordnung zu einem zuvor vorhandenen Aktivitätsbezeichner festgelegt. Wenn der Treiber SetActivityId aufruft, wird jeder vorhandene Aktivitätsbezeichner überschrieben.
Um eine Zuordnung festzulegen, rufen Sie den vorhandenen Bezeichner durch Aufrufen von RetrieveActivityId ab, und ordnen Sie dann den vorhandenen Bezeichner dem neuen zu, indem Sie EventWriteTransfer aufrufen.
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 WdfRequestSetActivityId.
Beispiele
Ein Codebeispiel, das SetActivityId verwendet, finden Sie unter RetrieveActivityId.
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 |