Funzione FsRtlGetSupportedFeatures (ntifs.h)

  • Articolo

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