IWDFIoRequest3：：SetActivityId 方法 (wudfddi.h)
[警告： UMDF 2 是最新版本的 UMDF，并取代 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 不会向 UMDF 1 添加任何新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。]
SetActivityId 方法将活动标识符与 I/O 请求相关联。
语法
void SetActivityId(
[in] LPGUID ActivityId
);
参数
[in] ActivityId
指向要存储在 I/O 请求中的活动标识符 GUID 的指针。
返回值
无
备注
调用 SetActivityId 不会设置与之前提供的任何活动标识符的关联。 当驱动程序调用 SetActivityId 时，将覆盖任何现有活动标识符。
若要设置关联，请通过调用 RetrieveActivityId 检索现有标识符，然后通过调用 EventWriteTransfer 将现有标识符与新标识符相关联。
当驱动程序调用 IWdfIoRequest2：：Reuse 时，框架不会清除请求的活动标识符。
有关活动标识符的详细信息，请参阅 使用活动标识符。
此方法的 UMDF 2 等效项是 WdfRequestSetActivityId。
示例
有关使用 SetActivityId 的代码示例，请参阅 RetrieveActivityId。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 |
| 结束支持 | 在 UMDF 2.0 及更高版本中不可用。 |
| 目标平台 | 桌面 |
| 最低 UMDF 版本 | 1.11 |
| 标头 | wudfddi.h (包括 Wudfddi.h) |
| DLL | WUDFx.dll |