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	沒有任何活動標識碼與要求相關聯。

方法可能會傳回其他NTSTATUS 值。

只有在啟用核心追蹤提供者時，或是在收到要求之後呼叫 WdfRequestSetActivity Id 的 UMDF 驅動程式時，才會有活動標識碼可供使用。如需 Windows 事件追蹤的詳細資訊（ETW），請參閱事件追蹤。

只有在先前呼叫 WdfRequestSetActivityId的 UMDF 驅動程式時，UMDF 驅動程式才會有活動標識符。

當驅動程式呼叫 WdfRequestReuse時，架構不會清除要求的活動標識符。

如需活動標識碼的詳細資訊，請參閱使用活動標識碼。