FltRegisterFilter 함수

참고 자료 : https://docs.microsoft.com/en-us/windows-hardware/drivers/ddi/fltkernel/nf-fltkernel-fltregisterfilter?redirectedfrom=MSDN

FltRegisterFilter function (fltkernel.h) - Windows drivers

함수 기능 : 미니 필터 드라이버를 등록한다

NTSTATUS FLTAPI FltRegisterFilter(
  PDRIVER_OBJECT         Driver,
  const FLT_REGISTRATION *Registration,
  PFLT_FILTER            *RetFilter
);

Parameter 설명,
Driver :
DRIVER_OBJECT 구조체로서, 미니필터 드라이버를 위한 드라이버 오브젝트 포인터
--> DRIVER_OBJECT 는 로드된 커널 모드 드라이버의 이미지를 대신한다.

드라이버 오브젝트 포인터와 미니필터 드라이버의 DriverEntry 루틴으로 들어온 입력과 같아야합니다.

Registration : 
호출자 할당된 미니필터 드라이버 등록 구조체 포인터
--> FLT_REGISTRATION 구조체는 FltRegisterFilter 함수로 전달 한다.

RetFilter : 
호출자에 대한 불투명한 필터 포인터를 받는 호출자 할당 포인터 변수

반환 값 :
FltRegisterFilter 는 STATUS_SUCCESS 또는 적당한 NTSTATUS 값을 반환한다.
반환값에 대해서, 위에 참고한 페이지를 살펴보면 된다.

참고 :
- 모든 minifilter driver는 미니 필터 드라이버의  전체 목록에서 자신을 추가하고 미니 필터 드라이버에 대한 콜백 기능 및 기타 정보 목록을 필터 관리자에 제공하려면 DriverEntry 루틴에서 FltRegisterFilter를 호출해야 한다.

- FltRegisterFilter는 *RetFilter의 미니 필터 드라이버에 대한 불투명한 필터 포인터를 반환합니다. 이 포인터 값은 미니 필터 드라이버를 고유하게 식별하고 미니 필터 드라이버가 로드되는 한 일정하게 유지됩니다. 미니 필터 드라이버는 FltStartFiltering 및 FltUnregisterFilter의 필수 매개 변수 이므로 포인터를 저장해야합니다.

- FltRegisterFilter를 호출 한 후, 미니 필터 드라이버는 일반적으로 FltStartFiltering 을 호출 하여  I/O 작업 필터링을 시작합니다.

- 등록하는 기능이 있으니, 등록 해제하는 기능이 있다.
FltUnregisterFilter 함수 참고.