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 时，框架不会清除请求的活动标识符。

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