Метод 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 идентификатора действия для хранения в запросе ввода-вывода.
Возвращаемое значение
Никакой
Замечания
Вызов SetActivityId не устанавливает связь с любым ранее указанным идентификатором действия. Когда драйвер вызывает SetActivityId, любой существующий идентификатор действия перезаписывается.
Чтобы задать связь, получите существующий идентификатор путем вызова RetrieveActivityId, а затем свяжите существующий идентификатор с новым путем вызова EventWriteTransfer.
Платформа не очищает идентификатор действия запроса, когда драйвер вызывает IWdfIoRequest2::Reuse.
Дополнительные сведения об идентификаторах действий см. в разделе Использование идентификаторов действий.
Эквивалент UMDF 2 этого метода WdfRequestSetActivityId.
Примеры
Пример кода, использующий SetActivityId, см. в разделе RetrieveActivityId.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Windows 8 |
завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
целевая платформа | Настольный |
минимальная версия UMDF | 1.11 |
заголовка | wudfddi.h (include Wudfddi.h) |
DLL | WUDFx.dll |