Funzione FsRtlGetSupportedFeatures (ntifs.h)

Articolo
12/21/2024

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 chiamante fornito valore di ULONG. 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
SUPPORTED_FS_FEATURES_OFFLOAD_READ 0x01	Il volume supporta operazioni di lettura scaricate.
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 vengono restituite correttamente le funzionalità supportate per il volume collegato a DeviceObject. 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.

Osservazioni

Gestione filtri esamina le funzionalità supportate, specificate da SupportedFeatures di un minifiltro valore del Registro di sistema, 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. Le funzionalità supportate ("SprtFtrs") possono essere sottoposte a query eseguendo fltmc instances in una finestra del prompt dei comandi con privilegi elevati.

Fabbisogno

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

Condividi tramite