FltGetLowerInstance 함수(fltkernel.h)

FltGetLowerInstance 루틴은 동일한 볼륨의 지정된 미니 필터 드라이버 인스턴스 아래에 연결된 다음 하위 미니 필터 드라이버 인스턴스에 대한 불투명 인스턴스 포인터를 반환합니다.

통사론

NTSTATUS FLTAPI FltGetLowerInstance(
  [in]  PFLT_INSTANCE CurrentInstance,
  [out] PFLT_INSTANCE *LowerInstance
);

매개 변수

[in] CurrentInstance

하위 미니 필터 드라이버 인스턴스가 요청되는 미니 필터 드라이버 인스턴스에 대한 불투명 인스턴스 포인터입니다.

[out] LowerInstance

다음 하위 미니 필터 드라이버 인스턴스에 대한 불투명 미니 필터 드라이버 인스턴스 포인터를 수신하는 호출자 할당 변수에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL 수 없습니다.

반환 값

FltGetLowerInstance STATUS_SUCCESS 또는 다음과 같은 적절한 NTSTATUS 값을 반환합니다.

발언

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

고도는 0에서 9까지의 하나 이상의 소수 자릿수로 구성된 계산된 유니코드 문자열인 고도 문자열지정되며 단일 소수점을 포함할 수 있습니다. 예를 들어 "100.123456" 및 "03333"은 유효한 고도 문자열입니다.

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

FltGetLowerInstanceLowerInstance 매개 변수에 반환된 불투명 인스턴스 포인터에 런다운 참조를 추가합니다. 이 포인터가 더 이상 필요하지 않으면 호출자는 FltObjectDereference호출하여 해제해야 합니다. 따라서 FltGetLowerInstance 대한 모든 성공적인 호출은 FltObjectDereference대한 후속 호출과 일치해야 합니다.

요구 사항

참고 항목

FltAttachVolume

FltAttachVolumeAtAltitude

fltCompareInstanceAltitudes

fltGetBottomInstance

fltGetTopInstance

fltGetUpperInstance

FltObjectDereference