Fonction FsRtlGetSupportedFeatures (ntifs.h)

  • Article

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 ULONG fournie par l’appelant. Au retour, cette valeur contient les indicateurs de fonctionnalité pris en charge pour le volume attaché. Consultez la section Notes.

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

Valeur Signification
0x01 SUPPORTED_FS_FEATURES_OFFLOAD_READ 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 retournée

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 telle que l’une des valeurs suivantes est retournée.

Code de retour 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 ne se trouve pas dans une pile d’appareils de système de fichiers.

Remarques

Le Gestionnaire de filtres examine les fonctionnalités prises en charge, spécifiées par la valeur du registre SupportedFeatures d’un minifiltre, pour chaque minifiltre attaché au volume. Chaque minifiltre 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8
Plateforme cible Universal
En-tête ntifs.h (inclure Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL