Поделиться через


Метод 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

См. также

IWDFIoRequest3

IWDFIoRequest3::RetrieveActivityId

WdfRequestSetActivityId