FilterCreate 함수(fltuser.h)

FilterCreate 함수는 지정된 미니필터에 대한 핸들을 만듭니다.

구문

HRESULT FilterCreate(
  [in]  LPCWSTR lpFilterName,
  [out] HFILTER *hFilter
);

[in] lpFilterName

미니필터의 이름을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

[out] hFilter

FilterCreate 호출이 성공하는 경우 미니필터에 대한 핸들을 수신하는 호출자가 할당한 변수에 대한 포인터입니다. 그렇지 않으면 INVALID_HANDLE_VALUE 받습니다.

FilterCreate 는 성공하면 S_OK 반환합니다. 그렇지 않으면 오류 값이 반환됩니다.

사용자 모드 애플리케이션은 FilterCreate 를 호출하여 커널 모드 미니필터와 통신하는 데 사용할 수 있는 핸들을 만듭니다. 반환된 미니필터 핸들을 FilterGetInformation과 같은 함수에 매개 변수로 전달할 수 있습니다.

FilterCreate에서 반환된 필터 핸들을 닫려면 FilterClose를 호출합니다.