FsRtlGetSupportedFeatures 함수(ntifs.h)

FsRtlGetSupportedFeatures 루틴은 지정된 디바이스 개체에 연결된 볼륨의 지원되는 기능을 반환합니다.

구문

NTSTATUS FsRtlGetSupportedFeatures(
  [in]  PDEVICE_OBJECT DeviceObject,
  [out] PULONG         SupportedFeatures
);

매개 변수

[in] DeviceObject

볼륨에 연결된 대상 디바이스 개체입니다.

[out] SupportedFeatures

호출자가 제공한 ULONG 값에 대한 포인터입니다. 반환할 때 이 값에는 연결된 볼륨에 대해 지원되는 기능 플래그가 포함됩니다. 설명 부분을 참조하세요.

지원되는 기능은 다음 플래그의 비트 OR 조합입니다.

값	의미
SUPPORTED_FS_FEATURES_OFFLOAD_READ 0x01	볼륨은 오프로드된 읽기 작업을 지원합니다.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE 0x02	볼륨은 오프로드된 쓰기 작업을 지원합니다.
SUPPORTED_FS_FEATURES_QUERY_OPEN 0x04	볼륨은 쿼리 열기 작업을 지원합니다.
SUPPORTED_FS_FEATURES_BYPASS_IO 0x08	볼륨은 BypassIO를 지원합니다. 이 플래그는 Windows 11 시작해서 사용할 수 있습니다.

반환 값

FsRtlGetSupportedFeatures는DeviceObject에 연결된 볼륨에 지원되는 기능이 성공적으로 반환되면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 다음 중 하나와 같은 NTSTATUS 값이 반환됩니다.

반환 코드	설명
STATUS_FLT_VOLUME_NOT_FOUND	DeviceObject에 대한 볼륨을 찾을 수 없습니다.
STATUS_FLT_INTERNAL_ERROR	DeviceObject에 지정된 디바이스 개체가 파일 시스템 디바이스 스택에 없습니다.

설명

필터 관리자는 볼륨에 연결된 모든 미니필터에 대해 미니필터의 SupportedFeatures 레지스트리 값으로 지정된 지원되는 기능을 확인합니다. 연결된 모든 미니필터는 해당 기능 비트를 설정하려면 특정 기능을 지원해야 합니다. SupportedFeatures 값은 파일 시스템에 적용되지 않습니다. 지원되는 기능("SprtFtrs")은 관리자 권한 명령 프롬프트 창에서 를 실행 fltmc instances 하여 쿼리할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
대상 플랫폼	유니버설
헤더	ntifs.h(Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL