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

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