IWDFIoRequest3：：SetActivityId 方法 （wudfddi.h）
[警告： UMDF 2 是最新版本的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，而且較新版本的 Windows 10 上對 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 |