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 |