Функция FsRtlGetSupportedFeatures (ntifs.h)

Статья
12/21/2024

Подпрограмма FsRtlGetSupportedFeatures возвращает поддерживаемые функции тома, подключенного к указанному объекту устройства.

Синтаксис

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

Параметры

[in] DeviceObject

Целевой объект устройства, подключенный к тому.

[out] SupportedFeatures

Указатель на указанное вызывающим значение ULONG. При возврате это значение содержит поддерживаемые флаги компонентов для подключенного тома. См. примечания.

Поддерживаемые функции — это побитовая комбинация или следующих флагов.

Ценность	Значение
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 возвращает STATUS_SUCCESS, если возвращены поддерживаемые функции тома, подключенного к DeviceObject. В противном случае возвращается значение NTSTATUS , например одно из следующих значений.

Возвращаемый код	Описание
STATUS_FLT_VOLUME_NOT_FOUND	Том не найден для DeviceObject.
STATUS_FLT_INTERNAL_ERROR	Объект устройства, указанный DeviceObject, не находится в стеке устройств файловой системы.

Замечания

Диспетчер фильтров рассматривает поддерживаемые функции, указанные поддерживаемых функций поддерживаемыхfeatures реестра для каждого минифильтратора, подключенного к тому. Каждый подключенный мини-фильтр должен поддерживать определенную функцию для задания бита этой функции. Значение SupportedFeatures не применяется к файловым системам. Поддерживаемые функции (SprtFtrs) можно запрашивать, выполнив fltmc instances в окне командной строки с повышенными привилегиями.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Поделиться через