WdfRequestSetActivityId 函式 (wdfrequest.h)

[僅適用於 UMDF]

WdfRequestSetActivityId 方法會將活動標識碼與 I/O 要求產生關聯。

語法

VOID WdfRequestSetActivityId(
  [in] WDFREQUEST Request,
  [in] LPGUID     ActivityId
);

參數

[in] Request

架構要求物件的句柄。

[in] ActivityId

要儲存在 I/O 要求中的活動標識碼 GUID 指標。

傳回值

沒有

言論

呼叫 WdfRequestSetActivityId 並不會設定與任何先前存在的活動標識符的關聯。 當驅動程式呼叫 WdfRequestSetActivityId時,會覆寫任何現有的活動標識符。

若要設定關聯,請藉由呼叫 WdfRequestRetrieveActivityId 擷取現有的標識碼,然後藉由呼叫 EventWriteTransfer,將現有的標識符與新的標識符產生關聯。

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

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

要求

要求 價值
最低支援的用戶端 Windows 8.1
目標平臺 普遍
最低 UMDF 版本 2.0
標頭 wdfrequest.h (包括 Wdf.h)
連結庫 WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

另請參閱

WdfRequestRetrieveActivityId