Функция FltPropagateActivityIdToThread (fltkernel.h)
Подпрограмма FltPropagateActivityIdToThread связывает идентификатор действия из IRP в данных обратного вызова минифильтра с текущим потоком.
Синтаксис
NTSTATUS FLTAPI FltPropagateActivityIdToThread(
[in] PFLT_CALLBACK_DATA CallbackData,
[in/out] LPGUID PropagateId,
[out] LPCGUID *OriginalId
);
Параметры
[in] CallbackData
Указатель на данные обратного вызова, содержащие запрос с соответствующим идентификатором действия.
[in/out] PropagateId
Указатель на выделенный вызывающий объект GUID, в которой хранится идентификатор действия для текущего потока.
[out] OriginalId
При возврате указатель GUID guid, на который ссылается OriginalId указывает идентификатор действия, заданный ранее для потока.
Возвращаемое значение
FltPropagateActivityIdToThread возвращает одно из следующих значений NTSTATUS.
| Возвращаемый код | Описание |
|---|---|
| STATUS_NOT_SUPPORTED | Данные обратного вызова не содержат запрос на операцию IRP. |
| STATUS_NOT_FOUND | Идентификатор действия не связан с запросом в CallbackData. |
| STATUS_SUCCESS | Идентификатор действия был возвращен в GUID, на которое указывает OriginalId. |
Замечания
Подпрограмма FltPropagateActivityIdToThread используется трассировки с учетом минифильтров. Минифильтр использует эту подпрограмму для присоединения идентификатора действия от IRP к рабочему потоку обработки ввода-вывода для запроса.
Мини-фильтр должен вызывать IoClearActivityIdThread с указателем в OriginalId, прежде чем возвращать управление из рабочего потока, если вызов FltPropagateActivityIdToThread был успешным.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 8. |
| целевая платформа | Всеобщий |
| заголовка | fltkernel.h (include Fltkernel.h) |
| библиотеки | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= DISPATCH_LEVEL |