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

Статья
08/07/2023

FltCompareInstanceAltitudes сравнивает высоты двух экземпляров драйвера минифильтра.

Синтаксис

LONG FLTAPI FltCompareInstanceAltitudes(
  [in] PFLT_INSTANCE Instance1,
  [in] PFLT_INSTANCE Instance2
);

Параметры

[in] Instance1

Указатель на первый экземпляр.

[in] Instance2

Указатель на второй экземпляр.

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

FltCompareInstanceAltitudes возвращает значение со знаком, которое дает результаты сравнения следующим образом:

Код возврата	Описание
Нуль	Экземпляр 1 подключен на той же высоте, что и Экземпляр 2. Это может произойти только в том случае, если Экземпляры 1 и Экземпляр2 подключены к разным томам или экземпляры Instance1 и Instance2 являются указателями на один и тот же экземпляр.
Меньше нуля	Экземпляр 1 подключен на более низкой высоте, чем Экземпляр 2.
Больше нуля	Экземпляр 1 подключен на большей высоте, чем Экземпляр 2.

Экземпляры драйвера минифильтра, на которые указывают экземпляры Instance1 и Instance2 , могут быть экземплярами одного драйвера минифильтра или разных драйверов минифильтра. Однако они должны быть присоединены к одному тому, если результат, возвращаемый FltCompareInstanceAltitudes , должен быть значимым.

Термин "высота" относится к позиции, которую экземпляр занимает (или должен занимать) в стеке экземпляров драйвера минифильтра для тома. Чем выше высота, тем дальше экземпляр находится от базовой файловой системы в стеке. На заданной высоте на заданном томе может быть присоединен только один экземпляр.

Высота задается строкой высоты, которая представляет собой подсчитываемую строку Юникода, состоящую из одной или нескольких десятичных цифр от 0 до 9; Строка может содержать одну десятичную запятую. Например, "100,123456" и "03333" являются допустимыми строками высоты.

Строка "03333" представляет большую высоту, чем "100,123456" (начальные и конечные нули игнорируются). Иными словами, экземпляр с высотой 03333 находится дальше от базовой файловой системы, чем экземпляр с высотой 100,123456. Однако это сравнение имеет смысл только в том случае, если оба экземпляра подключены к одному тому.

Чтобы подключить экземпляр драйвера минифильтра к тому, вызовите FltAttachVolume или FltAttachVolumeAtAltitude.

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

Требования

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

См. также раздел

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltDetachVolume

Поделиться через