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。

要求

另请参阅

IWDFIoRequest3

IWDFIoRequest3：：RetrieveActivityId

WdfRequestSetActivityId