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

Статья
08/07/2023

Подпрограмма FltIsOperationSynchronous определяет, представляет ли данная структура данных обратного вызова (FLT_CALLBACK_DATA) синхронную или асинхронную операцию ввода-вывода.

Синтаксис

BOOLEAN FLTAPI FltIsOperationSynchronous(
  [in] PFLT_CALLBACK_DATA CallbackData
);

Параметры

[in] CallbackData

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

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

FltIsOperationSynchronous возвращает значение TRUE, если операция синхронная, и false, если операция является асинхронной.

FltIsOperationSynchronous определяет, представляет ли данная структура данных обратного вызова (FLT_CALLBACK_DATA) синхронную или асинхронную операцию ввода-вывода в соответствии со следующими условиями:

Если операция не является операцией ввода-вывода на основе IRP, операция является синхронной. Чтобы определить, основана ли операция на IRP, используйте макрос FLT_IS_IRP_OPERATION .
Если операция является асинхронной операцией ввода-вывода подкачки, операция является асинхронной, даже если выполняется одно из других условий в этом списке.
Если операция является синхронной операцией ввода-вывода на разбиение по страницам, операция является синхронной.
Если объект файла для операции был открыт для синхронного ввода-вывода, операция является синхронной.
Если флаг IRP_SYNCHRONOUS_API установлен в IRP для операции, операция является синхронной. Этот флаг устанавливается для таких операций, как IRP_MJ_QUERY_INFORMATION и IRP_MJ_SET_INFORMATION, которые всегда синхронны, даже если они выполняются в файловом объекте, открытом для асинхронного ввода-вывода.
Если ни одно из указанных выше условий не выполняется, операция является асинхронной.

Примечание

FltIsOperationSynchronous также возвращает значение TRUE, если структура данных обратного вызова представляет операцию IRP_MJ_DEVICE_CONTROL, IRP_MJ_INTERNAL_DEVICE_CONTROL или IRP_MJ_FILE_SYSTEM_CONTROL с кодом управления вводом-выводом (IOCTL) или кодом управления файловой системой (FSCTL), который был определен с помощью METHOD_BUFFERED, даже если объект файла был открыт для асинхронного ввода-вывода. Такой запрос, скорее всего, будет выполнен синхронно файловой системой, но это не обязательно верно во всех случаях.

Когда FltIsOperationSynchronous возвращает значение TRUE, это не означает, что операция ввода-вывода синхронизирована. То есть значение TRUE не указывает, что драйвер минифильтра вернул FLT_PREOP_SYNCHRONIZE в подпрограмме обратного вызова перед операцией (PFLT_POST_OPERATION_CALLBACK) для этой операции. Вместо этого FltIsOperationSynchronous возвращает значение TRUE, чтобы указать, что операция ввода-вывода синхронна с точки зрения диспетчера ввода-вывода.

FltIsOperationSynchronous можно вызывать для всех классов операций: быстрых операций ввода-вывода, обратных вызовов фильтра файловой системы (FSFilter) и операций на основе IRP.

Требования

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