Метод IWDFIoRequest3::SetActivityId (wudfddi.h)
[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]
Метод SetActivityId связывает идентификатор действия с запросом ввода-вывода.
Синтаксис
void SetActivityId(
[in] LPGUID ActivityId
);
Параметры
[in] ActivityId
Указатель на guid идентификатора действия для хранения в запросе ввода-вывода.
Возвращаемое значение
None
Remarks
Вызов 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 |