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


Функция WdfRequestSetActivityId (wdfrequest.h)

[Применимо только к UMDF]

Метод WdfRequestSetActivityId связывает идентификатор действия с запросом ввода-вывода.

Синтаксис

void WdfRequestSetActivityId(
  [in] WDFREQUEST Request,
  [in] LPGUID     ActivityId
);

Параметры

[in] Request

Дескриптор объекта запроса платформы.

[in] ActivityId

Указатель на GUID идентификатора действия для хранения в запросе ввода-вывода.

Возвращаемое значение

Никакой

Замечания

Вызов WdfRequestSetActivityId не устанавливает связь с любым ранее указанным идентификатором действия. Когда драйвер вызывает WdfRequestSetActivityId, любой существующий идентификатор действия перезаписывается.

Чтобы задать связь, получите существующий идентификатор, вызвав WdfRequestRetrieveActivityId, а затем свяжите существующий идентификатор с новым путем вызова EventWriteTransfer.

Платформа не очищает идентификатор действия запроса, когда драйвер вызывает WdfRequestRequestReuse.

Дополнительные сведения об идентификаторах действий см. в разделе Использование идентификаторов действий.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 8.1
целевая платформа Всеобщий
минимальная версия UMDF 2.0
заголовка wdfrequest.h (включая Wdf.h)
библиотеки WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

См. также

WdfRequestRetrieveActivityId