Compartir a través de

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. A cambio, este valor contiene las marcas de características admitidas para el volumen adjunto. Vea 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 asociado a DeviceObject se devuelven correctamente. De lo contrario, se devuelve un valor de 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.

Observaciones

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

Requisitos

Requisito Valor
cliente mínimo admitido Windows 8
de la plataforma de destino de Universal
encabezado de ntifs.h (incluya Ntifs.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe
irQL <= APC_LEVEL