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

Статья
08/07/2023

Подпрограмма FltRegisterForDataScan позволяет проверять данные тома, подключенного к экземпляру минифильтра.

Синтаксис

NTSTATUS FLTAPI FltRegisterForDataScan(
  [in] PFLT_INSTANCE Instance
);

Параметры

[in] Instance

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

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

FltRegisterForDataScan возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например одно из следующих значений.

Код возврата	Описание
STATUS_NOT_SUPPORTED	Диспетчер фильтров не поддерживает сканирование данных для тома, подключенного к этому экземпляру.

Минифильтр, выполняющий сканирование данных, должен зарегистрировать свой том для сканирования путем вызова FltRegisterForDataScan перед вызовом FltCreateSectionForDataScan. Минифильтры сканируют данные по различным причинам, например по обнаружению вирусов, шифрованию или сжатию.

Примечание

Если FltRegisterForDataScan возвращает STATUS_NOT_SUPPORTED, минифильтр по-прежнему может создавать разделы для сканирования данных, вызвав FsRtlCreateSectionForDataScan. Однако доступ к разделу, созданному FsRtlCreateSectionForDataScan , не синхронизирован, и за обработку любых возникающих конфликтов отвечает вызывающий минифильтр. Такой минифильтр должен реализовывать и регистрировать PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK подпрограмму обратного вызова, которую можно вызывать при возникновении конфликта разделов.

Требования

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