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

Статья
08/07/2023

FltCompletePendedPreOperation возобновляет обработку операции ввода-вывода, которая была выполнена в подпрограмме обратного вызова драйвера мини-фильтра (PFLT_PRE_OPERATION_CALLBACK).

Синтаксис

VOID FLTAPI FltCompletePendedPreOperation(
                 PFLT_CALLBACK_DATA        CallbackData,
  [in]           FLT_PREOP_CALLBACK_STATUS CallbackStatus,
  [in, optional] PVOID                     Context
);

Параметры

CallbackData

Указатель на структуру данных обратного вызова (FLT_CALLBACK_DATA) для операции ввода-вывода. Этот параметр является обязательным и не может иметь значение NULL.

[in] CallbackStatus

Значение состояния, возвращаемое драйвером минифильтра для этой операции ввода-вывода. Не может быть FLT_PREOP_PENDING, FLT_PREOP_SYNCHRONIZE или FLT_PREOP_DISALLOW_FASTIO. Должно быть одним из следующих FLT_PREOP_CALLBACK_STATUS значений. Дополнительные сведения о влиянии этих значений см. в разделе Примечания справочной записи для PFLT_PRE_OPERATION_CALLBACK.

Значение	Значение
FLT_PREOP_COMPLETE	Драйвер минифильтра завершает операцию ввода-вывода. Диспетчер фильтров не отправляет операции ввода-вывода в драйверы минифильтра под вызывающим элементом или в файловую систему. Диспетчер фильтров вызывает только процедуры обратного вызова после операции (PFLT_POST_OPERATION_CALLBACK) драйверов минифильтра над вызывающим.
FLT_PREOP_SUCCESS_NO_CALLBACK	Драйвер минифильтра возвращает управление операцией ввода-вывода диспетчеру фильтров. Диспетчер фильтров не вызывает соответствующий обратный вызов после операции, если он существует, во время завершения ввода-вывода.
FLT_PREOP_SUCCESS_WITH_CALLBACK	Драйвер минифильтра возвращает управление операцией ввода-вывода диспетчеру фильтров. Диспетчер фильтров вызывает соответствующий обратный вызов после операции во время завершения ввода-вывода.

[in, optional] Context

Если для параметра CallbackStatus указан FLT_PREOP_SUCCESS_WITH_CALLBACK, этот параметр является необязательным указателем контекста, передаваемым в соответствующую подпрограмму обратного вызова после операции. Если для параметра CallbackStatus указан FLT_PREOP_COMPLETE или FLT_PREOP_SUCCESS_NO_CALLBACK, этот параметр должен иметь значение NULL.

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

None

Remarks

Когда подпрограмма обратного вызова драйвера минифильтра (PFLT_PRE_OPERATION_CALLBACK) отправляет операцию ввода-вывода в рабочую очередь и возвращает FLT_PREOP_PENDING, диспетчер фильтров прекращает ее обработку. Когда операция в конечном итоге выведена из очереди и обработана, драйвер мини-фильтра должен вызвать FltCompletePendedPreOperation , чтобы вернуть операцию в диспетчер фильтров, который затем возобновляет обработку в соответствии с указанием CallbackStatus, указанного драйвером мини-фильтра.

Если параметр CallbackStatus имеет значение FLT_PREOP_COMPLETE, fltCompletePendedPreOperation можно вызвать по адресу IRQL <= DISPATCH_LEVEL. В противном случае вызывающие функции FltCompletePendedPreOperation должны выполняться в IRQL <= APC_LEVEL.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	FltMgr.lib
IRQL	См. раздел "Примечания".