WdfRequestSetActivityId 函数 (wdfrequest.h)

  • 项目

[仅适用于 UMDF]

WdfRequestSetActivityId 方法将活动标识符与 I/O 请求相关联。

语法

void WdfRequestSetActivityId(
  [in] WDFREQUEST Request,
  [in] LPGUID     ActivityId
);

参数

[in] Request

框架请求对象的句柄。

[in] ActivityId

指向要存储在 I/O 请求中的活动标识符 GUID 的指针。

返回值

无

备注

调用 WdfRequestSetActivityId 不会设置与任何以前存在的活动标识符的关联。 当驱动程序调用 WdfRequestSetActivityId 时，将覆盖任何现有活动标识符。

若要设置关联，请通过调用 WdfRequestRetrieveActivityId 检索现有标识符，然后通过调用 EventWriteTransfer 将现有标识符与新标识符相关联。

当驱动程序调用 WdfRequestReuse 时，框架不会清除请求的活动标识符。

有关活动标识符的详细信息，请参阅 使用活动标识符。

要求

要求 值
最低受支持的客户端 Windows 8.1
目标平台 通用
最低 UMDF 版本 2.0
标头 wdfrequest.h (包括 Wdf.h)
Library WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

另请参阅

WdfRequestRetrieveActivityId