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

Статья
12/05/2023

FltVetoBypassIo извлекает сведения, необходимые для применения вето на запрос BypassIO.

Синтаксис

NTSTATUS FLTAPI FltVetoBypassIo(
  [in] PFLT_CALLBACK_DATA    CallbackData,
  [in] PCFLT_RELATED_OBJECTS FltObjects,
  [in] NTSTATUS              OperationStatus,
  [in] PCUNICODE_STRING      FailureReason
);

Параметры

[in] CallbackData

Указатель на FLT_CALLBACK_DATA для FSCTL_MANAGE_BYPASS_IO.

[in] FltObjects

Указатель на структуру FLT_RELATED_OBJECTS для операции BypassIO.

[in] OperationStatus

Код ошибки NTSTATUS, предоставляемый фильтром для вето.

[in] FailureReason

Уникальная описательная строка, которая содержит сведения о том, почему фильтр налагает вето на запрос на включение BypassIO.

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

FltVetoBypassIo возвращает STATUS_SUCCESS после успешного завершения; В противном случае возвращается значение NTSTATUS, например одно из следующих значений.

Значение	Значение
STATUS_BUFFER_TOO_SMALL	Буфер вывода FSCTL слишком мал.
STATUS_INVALID_BUFFER_SIZE	Входной буфер FSCTL слишком мал.
STATUS_INVALID_PARAMETER_3	Не предоставлен соответствующий код ошибки.
STATUS_INVALID_PARAMETER_4	Не указана соответствующая причина сбоя.
STATUS_NOT_SUPPORTED	Запрошенная операция не поддерживается или не запрашивается из обратного вызова до операции.

Минифильтр вызывает FltVetoBypassIo , когда он намерен наказать вето на FS_BPIO_OP_ENABLE или FS_BPIO_OP_QUERY запрос на файл. Минифильтр должен вызывать эту подпрограмму только из обратного вызова перед операцией.

FltVetoBypassIo заполняет структуру, выделенную вызывающим объектом, FS_BPIO_OUTPUT , связанную с CallbackData , сведениями, необходимыми для наложения вето на запрос BypassIO. Вызывающий объект должен предоставить буфер, который достаточно велик для хранения структуры.

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

Дополнительные сведения см. в разделах BypassIO для драйверов фильтров и Поддержка операций BypassIO .