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），请参阅事件跟踪。

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

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

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