FltGetFilterFromName 함수(fltkernel.h)

아티클
02/26/2024

FltGetFilterFromName 루틴은 이름이 FilterName 매개 변수의 값과 일치하는 등록된 미니필터 드라이버에 대한 불투명 필터 포인터를 반환합니다.

구문

NTSTATUS FLTAPI FltGetFilterFromName(
  [in]  PCUNICODE_STRING FilterName,
  [out] PFLT_FILTER      *RetFilter
);

매개 변수

[in] FilterName

미니필터 드라이버 이름을 포함하는 UNICODE_STRING 구조체에 대한 포인터입니다. (이름 비교는 대/소문자를 구분하지 않습니다.)

[out] RetFilter

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

반환 값

FltGetFilterFromName 은 STATUS_SUCCESS 또는 다음 중 하나와 같은 적절한 NTSTATUS 값을 반환합니다.

반환 코드	설명
STATUS_FLT_DELETING_OBJECT	일치하는 미니필터 드라이버가 발견되었지만 철거되고 있습니다. 오류 코드입니다.
STATUS_FLT_FILTER_NOT_FOUND	일치하는 미니필터 드라이버를 찾을 수 없습니다. 오류 코드입니다.

설명

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

필터 관리자에 미니필터 드라이버를 등록하려면 FltRegisterFilter를 호출합니다.