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

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

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

Синтаксис

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

Параметры

[in] Request

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

[out] ActivityId

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

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

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

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

Замечания

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

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

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

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

Требования

См. также

WdfRequestSetActivityId