Función FsRtlGetSupportedFeatures (ntifs.h)

  • Artículo

La rutina FsRtlGetSupportedFeatures devuelve las características admitidas de un volumen asociado al objeto de dispositivo especificado.

Sintaxis

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

Parámetros

[in] DeviceObject

Objeto de dispositivo de destino asociado a un volumen.

[out] SupportedFeatures

Puntero a un valor de ULONG proporcionado por el autor de la llamada. Al devolver, este valor contiene las marcas de características admitidas para el volumen adjunto. Vea la sección Comentarios.

Las características admitidas son una combinación OR bit a bit de las marcas siguientes.

Valor Significado
SUPPORTED_FS_FEATURES_OFFLOAD_READ 0x01 El volumen admite operaciones de lectura descargadas.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE 0x02 El volumen admite operaciones de escritura descargadas.
SUPPORTED_FS_FEATURES_QUERY_OPEN 0x04 El volumen admite operaciones abiertas de consulta.
SUPPORTED_FS_FEATURES_BYPASS_IO 0x08 El volumen admite BypassIO. Esta marca está disponible a partir de Windows 11.

Valor devuelto

FsRtlGetSupportedFeatures devuelve STATUS_SUCCESS si las características admitidas para el volumen conectado a DeviceObject se devuelven correctamente. De lo contrario, se devuelve un valor NTSTATUS como uno de los siguientes.

Código devuelto Descripción
STATUS_FLT_VOLUME_NOT_FOUND No se encuentra ningún volumen para DeviceObject.
STATUS_FLT_INTERNAL_ERROR El objeto de dispositivo especificado por DeviceObject no está en una pila de dispositivos del sistema de archivos.

Comentarios

El Administrador de filtros examina las características admitidas, especificadas por el valor supportedFeatures Registry de un minifiltro, para cada minifiltro adjunto al volumen. Cada minifiltro adjunto debe admitir una característica específica para que se establezca ese bit de característica. El valor SupportedFeatures no se aplica a los sistemas de archivos. Se pueden consultar las características admitidas ("SprtFtrs") mediante la ejecución fltmc instances en una ventana del símbolo del sistema con privilegios elevados.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8
Plataforma de destino Universal
Encabezado ntifs.h (incluya Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= APC_LEVEL