IWDFIoRequest3：：RetrieveActivityId 方法 (wudfddi.h)
[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1，且較新版本的 Windows 10 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱使用 UMDF 使用者入門。]
RetrieveActivityId 方法會擷取與 I/O 要求相關聯的目前活動標識符。
語法
HRESULT RetrieveActivityId(
[out] LPGUID ActivityId
);
參數
[out] ActivityId
要儲存所擷取 GUID 之位置的指標。
傳回值
如果呼叫成功，RetrieveActivityId 會傳回S_OK。 否則，此方法可能會傳回下列其中一個值。
| 傳回碼 | Description |
|---|---|
|
沒有與要求相關聯的活動標識碼。 |
備註
只有在啟用核心追蹤提供者時，或是在收到要求之後呼叫 IWDFIoRequest3：：SetActivityId 的 UMDF 驅動程式時，才會有活動標識符可供使用。 如需 Windows 事件追蹤 (ETW) 的詳細資訊，請參閱 事件追蹤。
只有在先前稱為 IWDFIoRequest3：：SetActivityId 的 UMDF 驅動程式時，UMDF 驅動程式才會有活動標識碼可供使用。
當驅動程式呼叫 IWdfIoRequest2：：Reuse 時，架構不會清除要求的活動標識符。
如需活動標識碼的詳細資訊，請參閱 使用活動標識符。
這個方法的 UMDF 2 對等專案是 WdfRequestRetrieveActivityId。
範例
下列程式代碼範例顯示驅動程式可以從一個要求擷取活動標識碼，然後使用它來設定另一個要求的活動標識符。
hrQI = pWdfRequest->QueryInterface(IID_PPV_ARGS(&pOriginalRequest3));
ASSERT(SUCCEEDED(hrQI));
hrQI = pNewRequest->QueryInterface(IID_PPV_ARGS(&pNewRequest3));
ASSERT(SUCCEEDED(hrQI));
//
// Obtain activity id from original request and set in the new one
//
pOriginalRequest3->RetrieveActivityId(&activityId);
pNewRequest3->SetActivityId(&activityId);
pOriginalRequest3->Release();
pNewRequest3->Release();
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 終止支援 | UMDF 2.0 和更新版本中無法使用。 |
| 目標平台 | 桌面 |
| 最低UMDF版本 | 1.11 |
| 標頭 | wudfddi.h (包括 Wudfddi.h) |
| Dll | WUDFx.dll |