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

  • Статья

[Относится только к UMDF]

Метод WdfRequestRetrieveActivityId извлекает идентификатор текущего действия, связанный с запросом ввода-вывода.

Синтаксис

NTSTATUS WdfRequestRetrieveActivityId(
  [in]  WDFREQUEST Request,
  [out] LPGUID     ActivityId
);

Параметры

[in] Request

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

[out] ActivityId

Указатель на расположение для хранения полученного GUID.

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

Если операция выполнена успешно, WdfRequestRetrieveActivityId возвращает STATUS_SUCCESS. К дополнительным возвращаемым значениям относятся:

Код возврата Описание
STATUS_NOT_FOUND
 С запросом не связан идентификатор действия.
 

Метод может возвращать другие значения NTSTATUS.

Комментарии

Запросы, отраженные в режиме ядра, имеют идентификатор действия, доступный только в том случае, если включен поставщик трассировки ядра или драйвер UMDF с именем WdfRequestSetActivityId после получения запроса. Дополнительные сведения о трассировке событий Windows (ETW) см. в разделе Трассировка событий.

Запросы, инициированные драйвером UMDF, имеют идентификатор действия, доступный только в том случае, если драйвер UMDF ранее назывался WdfRequestSetActivityId.

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 8.1
Целевая платформа Универсальное
Минимальная версия UMDF 2,0
Верхняя часть wdfrequest.h (включая Wdf.h)
Библиотека WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

См. также раздел

WdfRequestSetActivityId