Funzione FltSupportsFileContextsEx (fltkernel.h)

Articolo
08/07/2023

La routine FltSupportsFileContextsEx determina se il file system o il gestore filtri supportano i contesti di file per un determinato file.

Sintassi

BOOLEAN FLTAPI FltSupportsFileContextsEx(
  [in]           PFILE_OBJECT  FileObject,
  [in, optional] PFLT_INSTANCE Instance
);

Parametri

[in] FileObject

Puntatore all'oggetto file che rappresenta il file il cui supporto del contesto di file viene sottoposto a query. Questo parametro è obbligatorio e non può essere NULL.

[in, optional] Instance

Puntatore dell'istanza opaca per il chiamante. Questo parametro è facoltativo e può essere NULL. Per altre informazioni su questo parametro, vedere la sezione Osservazioni di questa pagina.

Valore restituito

FltSupportsFileContextsEx restituisce TRUE se il file system o la gestione filtri supporta i contesti di file per il file; FALSE in caso contrario.

Commenti

I driver minifilter possono chiamare la routine FltSupportsFileContextsEx per determinare se il file system sottostante o il gestore filtri supporta i contesti di file per il file rappresentato da FileObject senza dover allocare un contesto e tentare di impostarlo. Se un tipo di contesto non è supportato in un file, il minifilter non può collegare un contesto a tale file.

Per i file system (ad esempio FAT) che supportano solo un singolo flusso di dati per file, i contesti di file sono equivalenti ai contesti di flusso. Tali file system supportano in genere contesti di flusso, ma non supportano contesti di file. La gestione filtri offre invece il supporto del contesto di file, usando il supporto esistente del file system per i contesti di flusso. Per le istanze minifilter associate a questi file system, FltSupportsFileContexts restituisce FALSE, mentre FltSupportsFileContextsEx restituisce TRUE (quando viene passato un valore non NULL valido per il parametro Instance ).

Se viene specificato un valore non NULL per il parametro Instance , FltSupportsFileContextsEx restituisce TRUE se il file system o il gestore filtri supporta i contesti di file per il file; FALSE in caso contrario.

Se il parametro Instance è NULL, FltSupportsFileContextsEx restituisce TRUE solo se il file system supporta contesti di file per il file. In caso contrario, restituisce FALSE, anche se gestione filtri supporta contesti di file per il file.

Si noti che un file system potrebbe supportare contesti di file per alcuni tipi di file, ma non per altri. Ad esempio, NTFS e FAT non supportano i contesti di file per il paging dei file.

Per altre informazioni sui contesti, vedere Informazioni sui contesti minifilter.

Requisiti

Requisito	Valore
Client minimo supportato	Questa routine è disponibile in Windows Vista e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (include Fltkernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL