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 |