Fonction FsRtlGetSupportedFeatures (ntifs.h)
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 |