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

Статья
02/06/2025

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

Синтаксис

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

Параметры

[in] Instance1

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

[in] Instance2

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

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

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

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

Замечания

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

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

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

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

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

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

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	fltkernel.h (include Fltkernel.h)
библиотеки	FltMgr.lib
IRQL	<= DISPATCH_LEVEL

См. также

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltDetachVolume

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