FltGetUpperInstance 함수(fltkernel.h)

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

통사론

NTSTATUS FLTAPI FltGetUpperInstance(
  [in]  PFLT_INSTANCE CurrentInstance,
  [out] PFLT_INSTANCE *UpperInstance
);

매개 변수

[in] CurrentInstance

다음 상위 인스턴스가 요청된 인스턴스에 대한 불투명 인스턴스 포인터입니다.

[out] UpperInstance

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

반환 값

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

반환 코드	묘사
STATUS_NO_MORE_ENTRIES	더 높은 인스턴스를 찾을 수 없습니다. 경고 코드입니다.

발언

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

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

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

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