FltCompareInstanceAltitudes 함수(fltkernel.h)

아티클
02/26/2024

FltCompareInstanceAltitudes는 두 미니필터 드라이버 인스턴스의 고도를 비교합니다.

구문

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

매개 변수

[in] Instance1

첫 번째 instance 대한 포인터입니다.

[in] Instance2

두 번째 instance 대한 포인터입니다.

반환 값

FltCompareInstanceAltitudes는 다음과 같이 비교 결과를 제공하는 부호 있는 값을 반환합니다.

반환 코드	설명
Zero	Instance1 은 Instance2와 동일한 고도에 연결됩니다. 이는 Instance1 및 Instance2가 서로 다른 볼륨에 연결되어 있거나 Instance1 및 Instance2가 동일한 instance 대한 포인터인 경우에만 발생할 수 있습니다.
0보다 작음	Instance1 은 Instance2보다 낮은 고도에서 연결됩니다.
0보다 큼	Instance1 은 Instance2보다 높은 고도에서 연결됩니다.

설명

Instance1 및 Instance2가 가리키는 미니필터 드라이버 인스턴스는 동일한 미니필터 드라이버 또는 다른 미니필터 드라이버의 인스턴스일 수 있습니다. 그러나 FltCompareInstanceAltitudes 에서 반환된 결과가 의미 있는 경우 동일한 볼륨에 연결해야 합니다.

"고도"라는 용어는 볼륨에 대한 미니필터 드라이버 instance 스택에서 instance 차지하거나 차지해야 하는 위치를 나타냅니다. 고도가 높을수록 스택의 기본 파일 시스템에서 instance 멀리 떨어져 있습니다. 지정된 볼륨의 지정된 고도에서 하나의 instance 연결할 수 있습니다.

고도는 0에서 9까지의 10진수 이상으로 구성된 계산된 유니코드 문자열인 고도 문자열에 의해 지정됩니다. 문자열에는 단일 소수점이 포함될 수 있습니다. 예를 들어 "100.123456" 및 "03333"은 유효한 고도 문자열입니다.

문자열 "03333"은 "100.123456"보다 높은 고도를 나타냅니다(선행 및 후행 0은 무시됨). 즉, 고도가 "03333"인 instance 고도가 "100.123456"인 instance 기본 파일 시스템에서 더 멀리 떨어져 있습니다. 그러나 이 비교는 두 인스턴스가 동일한 볼륨에 연결된 경우에만 의미가 있습니다.

볼륨에 instance 미니필터 드라이버를 연결하려면 FltAttachVolume 또는 FltAttachVolumeAtAltitude를 호출합니다.

볼륨에서 instance 미니필터 드라이버를 분리하려면 FltDetachVolume을 호출합니다.