Função FsRtlGetSupportedFeatures (ntifs.h)

  • Artigo

A rotina FsRtlGetSupportedFeatures retorna os recursos com suporte de um volume anexado ao objeto de dispositivo especificado.

Sintaxe

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

Parâmetros

[in] DeviceObject

O objeto de dispositivo de destino anexado a um volume.

[out] SupportedFeatures

Um ponteiro para um valor ULONG fornecido pelo chamador. No retorno, esse valor contém os sinalizadores de recursos com suporte para o volume anexado. Consulte Observações.

Os recursos com suporte são uma combinação OR bit a bit dos sinalizadores a seguir.

Valor Significado
SUPPORTED_FS_FEATURES_OFFLOAD_READ 0x01 O volume dá suporte a operações de leitura descarregadas.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE 0x02 O volume dá suporte a operações de gravação descarregadas.
SUPPORTED_FS_FEATURES_QUERY_OPEN 0x04 O volume dá suporte a operações abertas de consulta.
SUPPORTED_FS_FEATURES_BYPASS_IO 0x08 O volume dá suporte a BypassIO. Esse sinalizador está disponível a partir de Windows 11.

Retornar valor

FsRtlGetSupportedFeatures retornaráSTATUS_SUCCESS se os recursos com suporte para o volume anexado a DeviceObject forem retornados com êxito. Caso contrário, um valor NTSTATUS , como um dos seguintes, será retornado.

Código de retorno Descrição
STATUS_FLT_VOLUME_NOT_FOUND Nenhum volume foi encontrado para DeviceObject.
STATUS_FLT_INTERNAL_ERROR O objeto de dispositivo especificado por DeviceObject não está em uma pilha de dispositivos do sistema de arquivos.

Comentários

O Gerenciador de Filtros examina os recursos com suporte, especificados pelo valor do Registro SupportedFeatures de um minifiltro, para cada minifiltro anexado ao volume. Cada minifiltro anexado deve dar suporte a um recurso específico para que esse bit de recurso seja definido. O valor SupportedFeatures não se aplica a sistemas de arquivos. Os recursos com suporte ("SprtFtrs") podem ser consultados executando fltmc instances em uma janela de prompt de comando com privilégios elevados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL