FsRtlGetSupportedFeatures, fonction (ntifs.h)

Article
12/21/2024

La routine FsRtlGetSupportedFeatures retourne les fonctionnalités prises en charge d’un volume attaché à l’objet d’appareil spécifié.

Syntaxe

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

Paramètres

[in] DeviceObject

Objet d’appareil cible attaché à un volume.

[out] SupportedFeatures

Pointeur vers une valeur de ULONG fournie par l’appelant. Lors du retour, cette valeur contient les indicateurs de fonctionnalité pris en charge pour le volume attaché. Voir les remarques.

Les fonctionnalités prises en charge sont une combinaison OR au niveau du bit des indicateurs suivants.

Valeur	Signification
SUPPORTED_FS_FEATURES_OFFLOAD_READ 0x01	Le volume prend en charge les opérations de lecture déchargées.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE 0x02	Le volume prend en charge les opérations d’écriture déchargées.
SUPPORTED_FS_FEATURES_QUERY_OPEN 0x04	Le volume prend en charge les opérations d’ouverture de requête.
SUPPORTED_FS_FEATURES_BYPASS_IO 0x08	Le volume prend en charge BypassIO . Cet indicateur est disponible à partir de Windows 11.

Valeur de retour

FsRtlGetSupportedFeatures retourne STATUS_SUCCESS si les fonctionnalités prises en charge pour le volume attaché à DeviceObject sont retournées avec succès. Sinon, une valeur NTSTATUS comme l’une des valeurs suivantes est retournée.

Retourner le code	Description
STATUS_FLT_VOLUME_NOT_FOUND	Aucun volume n’est trouvé pour DeviceObject.
STATUS_FLT_INTERNAL_ERROR	L’objet d’appareil spécifié par DeviceObject n’est pas dans une pile d’appareils de système de fichiers.

Remarques

Filter Manager examine les fonctionnalités prises en charge, spécifiées par les SupportedFeatures d’un minifilter valeur de Registre, pour chaque mini-filtre attaché au volume. Chaque minifilter attaché doit prendre en charge une fonctionnalité spécifique pour que ce bit de fonctionnalité soit défini. La valeur SupportedFeatures ne s’applique pas aux systèmes de fichiers. Les fonctionnalités prises en charge (« SprtFtrs ») peuvent être interrogées en exécutant fltmc instances dans une fenêtre d’invite de commandes avec élévation de privilèges.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Partager via