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 开始可用。

返回值

如果成功返回附加到 DeviceObject 的卷支持的功能,FsRtlGetSupportedFeatures 将返回STATUS_SUCCESS。 否则,将返回如下所示的 NTSTATUS 值之一。

返回代码 说明
STATUS_FLT_VOLUME_NOT_FOUND 找不到 DeviceObject 的卷。
STATUS_FLT_INTERNAL_ERROR DeviceObject 指定的设备对象不在文件系统设备堆栈中。

注解

筛选器管理器针对附加到卷的每个微筛选器查看由微筛选器的 SupportedFeatures 注册表值指定的受支持功能。 每个附加的微筛选器都必须支持特定功能才能设置该功能位。 SupportedFeatures 值不适用于文件系统。 可以通过在提升的命令提示符窗口中运行 fltmc instances 来查询 (“SprtFtrs”) 支持的功能。

要求

要求
最低受支持的客户端 Windows 8
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL