wdfRequestRetrieveActivityId 函式 (wdfrequest.h)

[僅適用於 UMDF]

WdfRequestRetrieveActivityId 方法會擷取與 I/O 要求相關聯的目前活動標識符。

語法

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

[in] Request

架構要求物件的句柄。

[out] ActivityId

用來儲存所擷取 GUID 之位置的指標。

如果作業成功， WdfRequestRetrieveActivityId 會傳回STATUS_SUCCESS。其他傳回值包括：

傳回碼	Description
STATUS_NOT_FOUND	沒有與要求相關聯的活動標識碼。

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

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

只有在 UMDF 驅動程式先前稱為 WdfRequestSetActivityId 的 UMDF 驅動程式時，才能使用由 UMDF 驅動程式起始的要求。

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

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