FltGetFilterFromInstance 함수(fltkernel.h)

아티클
02/05/2022
읽는 데 2분 걸림

FltGetFilterFromInstance 루틴은 지정된 인스턴스를 만든 미니 필터 드라이버에 대한 불투명 필터 포인터를 반환합니다.

구문

NTSTATUS FLTAPI FltGetFilterFromInstance(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_FILTER   *RetFilter
);

매개 변수

[in] Instance

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

[out] RetFilter

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

반환 값

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

반환 코드	설명
STATUS_FLT_DELETING_OBJECT	미니 필터 드라이버가 철거되고 있습니다. 오류 코드입니다.

설명

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

지정된 미니 필터 드라이버 인스턴스가 연결된 볼륨에 대한 불투명 볼륨 포인터를 얻으려면 FltGetVolumeFromInstance를 호출합니다.

지정된 미니 필터 드라이버의 모든 인스턴스를 열거하려면 FltEnumerateInstanceInformationByFilter를 호출합니다.

모든 볼륨에서 모든 미니 필터 드라이버의 인스턴스를 열거하려면 FltEnumerateInstances를 호출합니다.