Функция FltSetActivityIdCallbackData (fltkernel.h)

Статья
04/30/2024

Подпрограмма FltSetActivityIdCallbackData задает идентификатор действия для IRP в данных обратного вызова минифильтра.

Синтаксис

NTSTATUS FLTAPI FltSetActivityIdCallbackData(
  [in, out]      PFLT_CALLBACK_DATA CallbackData,
  [in, optional] LPCGUID            Guid
);

Параметры

[in, out] CallbackData

Указатель на данные обратного вызова, содержащие запрос со связанным идентификатором действия.

[in, optional] Guid

Необязательный указатель на структуру GUID , получающий идентификатор действия. Если guid имеет значение NULL, система попытается назначить идентификатор действия ETW для запроса.

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

FltSetActivityIdCallbackData возвращает одно из следующих значений NTSTATUS .

Код возврата	Описание
STATUS_NOT_SUPPORTED	Данные обратного вызова не содержат запроса на операцию IRP. -или- Идентификатор GUID, на который указывает guid, не указан, и идентификатор действия трассировки событий Windows или операция отсутствуют.
STATUS_NOT_FOUND	Идентификатор действия не связан с запросом в CallbackData.
STATUS_SUCCESS	Идентификатор действия, на который указывает guid , был задан для IRP в CallbackData.

Код возврата

Описание

STATUS_NOT_SUPPORTED

Данные обратного вызова не содержат запроса на операцию IRP.

-или-

Идентификатор GUID, на который указывает guid, не указан, и идентификатор действия трассировки событий Windows или операция отсутствуют.

STATUS_NOT_FOUND

Идентификатор действия не связан с запросом в CallbackData.

STATUS_SUCCESS

Идентификатор действия, на который указывает guid , был задан для IRP в CallbackData.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= DISPATCH_LEVEL

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

FltGetActivityIdCallbackData

FltPropagateActivityIdToThread