FltGetVolumeFromInstance 함수(fltkernel.h)

FltGetVolumeFromInstance 루틴은 지정된 미니 필터 드라이버 인스턴스가 연결된 볼륨에 대한 불투명 포인터를 반환합니다.

통사론

NTSTATUS FLTAPI FltGetVolumeFromInstance(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_VOLUME   *RetVolume
);

매개 변수

[in] Instance

인스턴스에 대한 불투명 인스턴스 포인터입니다.

[out] RetVolume

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

반환 값

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

반환 코드	묘사
STATUS_FLT_DELETING_OBJECT	미니 필터 드라이버 인스턴스가 연결된 볼륨이 축소되고 있습니다. 오류 코드입니다.

발언

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

지정된 인스턴스를 만든 미니 필터 드라이버에 대한 불투명 필터 포인터를 얻으려면 FltGetFilterFromInstance호출합니다.

지정된 볼륨의 디바이스 개체에 대한 포인터를 얻으려면 FltGetDeviceObject호출합니다.

지정된 인스턴스가 연결된 볼륨에 대한 자세한 정보를 얻으려면 FltQueryVolumeInformation호출합니다.

요구 사항

요구	값
대상 플랫폼	보편적
헤더	fltkernel.h(Fltkernel.h 포함)
라이브러리	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

참고 항목

fltGetDeviceObject

FltGetFilterFromInstance

FltObjectDereference

FltQueryVolumeInformation