IWDFIoRequest3：：SetActivityId 方法 (wudfddi.h)
[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1，且較新版本的 #DDE31F35B4DB34A2A96F0E65A881CFEBA 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱使用 UMDF 使用者入門。]
SetActivityId 方法會將活動標識碼與 I/O 要求產生關聯。
語法
void SetActivityId(
[in] LPGUID ActivityId
);
參數
[in] ActivityId
要儲存在 I/O 要求的活動標識碼 GUID 指標。
傳回值
無
備註
呼叫 SetActivityId 不會設定與任何先前存在活動標識碼的關聯。 當驅動程式呼叫 SetActivityId 時，會覆寫任何現有的活動標識碼。
若要設定關聯，請呼叫 RetrieveActivityId 來擷取現有的標識碼，然後呼叫 EventWriteTransfer 將現有的標識碼與新的標識符產生關聯。
當驅動程式呼叫 IWdfIoRequest2：：Reuse 時，架構不會清除要求的活動標識符。
如需活動標識碼的詳細資訊，請參閱 使用活動標識符。
這個方法的 UMDF 2 對等專案是 WdfRequestSetActivityId。
範例
如需使用 SetActivityId 的程式代碼範例，請參閱 RetrieveActivityId。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 終止支援 | UMDF 2.0 和更新版本中無法使用。 |
| 目標平台 | 桌面 |
| 最低UMDF版本 | 1.11 |
| 標頭 | wudfddi.h (包括 Wudfddi.h) |
| Dll | WUDFx.dll |