FltSupportsFileContextsEx 함수(fltkernel.h)

아티클
02/26/2024

FltSupportsFileContextsEx 루틴은 파일 시스템 또는 필터 관리자가 지정된 파일에 대한 파일 컨텍스트를 지원하는지 여부를 결정합니다.

구문

BOOLEAN FLTAPI FltSupportsFileContextsEx(
  [in]           PFILE_OBJECT  FileObject,
  [in, optional] PFLT_INSTANCE Instance
);

매개 변수

[in] FileObject

파일 컨텍스트 지원을 쿼리하는 파일을 나타내는 파일 개체에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

[in, optional] Instance

호출자에 대한 불투명 instance 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 이 매개 변수에 대한 자세한 내용은 이 페이지의 설명 섹션을 참조하세요.

반환 값

파일 시스템 또는 필터 관리자가 파일에 대한 파일 컨텍스트를 지원하는 경우 FltSupportsFileContextsEx는 TRUE를 반환합니다. 그렇지 않으면 FALSE입니다.

설명

미니필터 드라이버는 FltSupportsFileContextsEx 루틴을 호출하여 기본 파일 시스템 또는 필터 관리자가 컨텍스트를 할당하고 설정하지 않고 도 FileObject 가 나타내는 파일에 대한 파일 컨텍스트를 지원하는지 여부를 확인할 수 있습니다. 컨텍스트 형식이 파일에서 지원되지 않는 경우 미니필터는 해당 파일에 컨텍스트를 연결할 수 없습니다.

파일당 단일 데이터 스트림만 지원하는 파일 시스템(예: FAT)의 경우 파일 컨텍스트는 스트림 컨텍스트와 동일합니다. 이러한 파일 시스템은 일반적으로 스트림 컨텍스트를 지원하지만 파일 컨텍스트는 지원하지 않습니다. 대신 필터 관리자는 스트림 컨텍스트에 대한 파일 시스템의 기존 지원을 사용하여 파일 컨텍스트 지원을 제공합니다. 이러한 파일 시스템에 연결된 미니필터 인스턴스의 경우 FltSupportsFileContexts는 FALSE를 반환하고 FltSupportsFileContextsEx는 TRUE를 반환합니다(인스턴스 매개 변수에 대해 유효한 비 NULL 값이 전달되는 경우).

인스턴스 매개 변수에 NULL이 아닌 값이 제공되면 파일 시스템 또는 필터 관리자가 파일에 대한 파일 컨텍스트를 지원하는 경우 FltSupportsFileContextsEx는 TRUE를 반환합니다. 그렇지 않으면 FALSE입니다.

Instance 매개 변수가 NULL인 경우 FltSupportsFileContextsEx는 파일 시스템에서 파일에 대한 파일 컨텍스트를 지원하는 경우에만 TRUE를 반환합니다. 그렇지 않으면 필터 관리자가 파일에 대한 파일 컨텍스트를 지원하는 경우에도 FALSE를 반환합니다.

파일 시스템은 일부 형식의 파일에 대한 파일 컨텍스트를 지원할 수 있지만 다른 형식의 파일 컨텍스트는 지원하지 않을 수 있습니다. 예를 들어 NTFS 및 FAT는 파일 페이징에 대한 파일 컨텍스트를 지원하지 않습니다.

컨텍스트에 대한 자세한 내용은 미니필터 컨텍스트 정보를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	이 루틴은 Windows Vista 이상에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	fltkernel.h(Fltkernel.h 포함)
라이브러리	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL