Função FsRtlGetSupportedFeatures (ntifs.h)

Artigo
12/21/2024

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 de ULONG fornecido pelo chamador. No retorno, esse valor contém os sinalizadores de recursos com suporte para o volume anexado. Consulte Comentários.

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 abypassIO . Esse sinalizador está disponível a partir do Windows 11.

Valor de retorno

FsRtlGetSupportedFeatures retornará STATUS_SUCCESS se os recursos com suporte para o volume anexado ao DeviceObject forem retornados com êxito. Caso contrário, um NTSTATUS valor, 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 pelo DeviceObject não está em uma pilha de dispositivos do sistema de arquivos.

Observações

O Gerenciador de Filtros analisa os recursos com suporte, especificados por um minifiltro valor supportedFeatures Registry, 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
de cliente com suporte mínimo	Windows 8
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Compartilhar via