WdfRequestRetrieveActivityId 函数 (wdfrequest.h)

  • 项目

[仅适用于 UMDF]

WdfRequestRetrieveActivityId 方法检索与 I/O 请求关联的当前活动标识符。

语法

NTSTATUS WdfRequestRetrieveActivityId(
  [in]  WDFREQUEST Request,
  [out] LPGUID     ActivityId
);

参数

[in] Request

框架请求对象的句柄。

[out] ActivityId

指向存储检索到的 GUID 的位置的指针。

返回值

如果操作成功， WdfRequestRetrieveActivityId 将返回STATUS_SUCCESS。 其他返回值包括：

返回代码 说明
STATUS_NOT_FOUND
 没有与请求关联的活动 ID。
 

该方法可能会返回其他 NTSTATUS 值。

注解

仅当启用了内核跟踪提供程序或 UMDF 驱动程序在收到请求后调用 WdfRequestSetActivityId 时，从内核模式反映的请求才具有可用的活动标识符。 有关 Windows (ETW) 的事件跟踪的详细信息，请参阅 事件跟踪。

仅当 UMDF 驱动程序以前调用 WdfRequestSetActivityId 时，UMDF 驱动程序发起的请求才具有活动标识符。

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

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

要求

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

另请参阅

WdfRequestSetActivityId