Funzione FsRtlGetSupportedFeatures (ntifs.h)
La routine FsRtlGetSupportedFeatures restituisce le funzionalità supportate di un volume collegato all'oggetto dispositivo specificato.
Sintassi
NTSTATUS FsRtlGetSupportedFeatures(
[in] PDEVICE_OBJECT DeviceObject,
[out] PULONG SupportedFeatures
);
Parametri
[in] DeviceObject
Oggetto dispositivo di destinazione collegato a un volume.
[out] SupportedFeatures
Puntatore a un valore ULONG fornito dal chiamante. In caso di restituzione, questo valore contiene i flag di funzionalità supportati per il volume associato. Vedere la sezione Osservazioni.
Le funzionalità supportate sono una combinazione OR bit per bit dei flag seguenti.
Valore | Significato |
---|---|
0x01 SUPPORTED_FS_FEATURES_OFFLOAD_READ | Il volume supporta operazioni di lettura offloaded. |
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE 0x02 | Il volume supporta operazioni di scrittura offloaded. |
SUPPORTED_FS_FEATURES_QUERY_OPEN 0x04 | Il volume supporta le operazioni di apertura delle query. |
SUPPORTED_FS_FEATURES_BYPASS_IO 0x08 | Il volume supporta BypassIO. Questo flag è disponibile a partire da Windows 11. |
Valore restituito
FsRtlGetSupportedFeatures restituisce STATUS_SUCCESS se le funzionalità supportate per il volume collegato a DeviceObject vengono restituite correttamente. In caso contrario, viene restituito un valore NTSTATUS , ad esempio uno dei seguenti.
Codice restituito | Descrizione |
---|---|
STATUS_FLT_VOLUME_NOT_FOUND | Non viene trovato alcun volume per DeviceObject. |
STATUS_FLT_INTERNAL_ERROR | L'oggetto dispositivo specificato da DeviceObject non si trova in uno stack di dispositivi del file system. |
Commenti
Gestione filtri esamina le funzionalità supportate, specificate dal valore SupportedFeatures Registry di un minifilter, per ogni minifiltro collegato al volume. Ogni minifiltro collegato deve supportare una funzionalità specifica affinché tale bit di funzionalità sia impostato. Il valore SupportedFeatures non si applica ai file system. È possibile eseguire query su funzionalità supportate ("SprtFtrs") eseguendo fltmc instances
in una finestra del prompt dei comandi con privilegi elevati.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 8 |
Piattaforma di destinazione | Universale |
Intestazione | ntifs.h (include Ntifs.h) |
Libreria | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |