FilterInstanceCreate 함수(fltuser.h)

FilterInstanceCreate 함수는 지정된 미니필터 instance 통신하는 데 사용할 수 있는 핸들을 만듭니다.

구문

HRESULT FilterInstanceCreate(
  [in]           LPCWSTR          lpFilterName,
  [in]           LPCWSTR          lpVolumeName,
  [in, optional] LPCWSTR          lpInstanceName,
  [out]          HFILTER_INSTANCE *hInstance
);

매개 변수

[in] lpFilterName

instance 소유하는 미니필터의 이름을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다.

[in] lpVolumeName

instance 연결된 볼륨의 이름을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다.

lpVolumeName 입력 문자열은 다음 중 한 개일 수 있습니다. 후행 백슬래시(\)는 선택 사항입니다.

• 드라이브 문자(예: "D:\"
• 볼륨 탑재 지점의 경로(예: "c:\mnt\edrive\"
• 고유한 볼륨 식별자( 볼륨 GUID 이름이라고도 함)(예: "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
• "\Device\HarddiskVolume1\"과 같은 존재하지 않는 디바이스 이름(대상 이름 또는 NT 디바이스 이름이라고도 함)입니다.

[in, optional] lpInstanceName

instance 대한 instance 이름을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. NULL인 경우 이 볼륨에서 이 미니필터에 대해 발견된 첫 번째 instance 반환됩니다.

[out] hInstance

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

반환 값

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

설명

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

FilterInstanceCreate에서 반환된 instance 핸들을 닫려면 FilterInstanceClose를 호출합니다.

요구 사항

추가 정보

FilterInstanceClose

FilterInstanceGetInformation