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 值

注解

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

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

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

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

要求

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

另请参阅

WdfRequestSetActivityId