WdfRequestRetrieveActivityId 函式 （wdfrequest.h）

[僅適用於 UMDF]

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

語法

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

參數

[in] Request

架構要求物件的句柄。

[out] ActivityId

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

傳回值

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

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

言論

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

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

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

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

要求

另請參閱

WdfRequestSetActivityId