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 時，架構不會清除要求的活動識別碼。

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

規格需求

需求 值
最低支援的用戶端 Windows 8.1
目標平台 Universal
最低UMDF版本 2.0
標頭 wdfrequest.h (包含 Wdf.h)
程式庫 WUDFx02000.lib
Dll WUDFx02000.dll
IRQL PASSIVE_LEVEL

另請參閱

WdfRequestSetActivityId