Fonction FltSupportsFileContextsEx (fltkernel.h)

Article
02/26/2024

La routine FltSupportsFileContextsEx détermine si le système de fichiers ou le gestionnaire de filtres prennent en charge les contextes de fichier pour un fichier donné.

Syntaxe

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

Paramètres

[in] FileObject

Pointeur vers l’objet de fichier qui représente le fichier dont la prise en charge du contexte de fichier est interrogée. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

[in, optional] Instance

Pointeur de instance opaque pour l’appelant. Ce paramètre est facultatif et peut être NULL. Pour plus d’informations sur ce paramètre, consultez la section Remarques de cette page.

Valeur retournée

FltSupportsFileContextsEx retourne TRUE si le système de fichiers ou le gestionnaire de filtres prend en charge les contextes de fichier pour le fichier ; FALSE dans le cas contraire.

Remarques

Les pilotes minifiltres peuvent appeler la routine FltSupportsFileContextsEx pour déterminer si le système de fichiers sous-jacent ou le gestionnaire de filtres prend en charge les contextes de fichier pour le fichier représenté par FileObject sans avoir à allouer un contexte et à tenter de le définir. Si un type de contexte n’est pas pris en charge sur un fichier, le minifiltre ne peut pas attacher de contexte à ce fichier.

Pour les systèmes de fichiers (tels que FAT) qui ne prennent en charge qu’un seul flux de données par fichier, les contextes de fichiers sont équivalents aux contextes de flux. Ces systèmes de fichiers prennent généralement en charge les contextes de flux, mais ne prennent pas en charge les contextes de fichiers. Au lieu de cela, le gestionnaire de filtres prend en charge le contexte des fichiers, en utilisant la prise en charge existante du système de fichiers pour les contextes de flux. Pour les instances de minifiltre attachées à ces systèmes de fichiers, FltSupportsFileContexts retourne FALSE, tandis que FltSupportsFileContextsEx retourne TRUE (lorsqu’une valeur non NULL valide est transmise pour le paramètre Instance ).

Si une valeur non NULL est fournie pour le paramètre Instance , FltSupportsFileContextsEx retourne TRUE si le système de fichiers ou le gestionnaire de filtres prend en charge les contextes de fichier pour le fichier ; FALSE dans le cas contraire.

Si le paramètre Instance a la valeur NULL, FltSupportsFileContextsEx retourne TRUE uniquement si le système de fichiers prend en charge les contextes de fichiers pour le fichier. Sinon, il retourne FALSE, même si le gestionnaire de filtres prend en charge les contextes de fichier pour le fichier.

Notez qu’un système de fichiers peut prendre en charge les contextes de fichiers pour certains types de fichiers, mais pas pour d’autres. Par exemple, NTFS et FAT ne prennent pas en charge les contextes de fichiers pour la pagination des fichiers.

Pour plus d’informations sur les contextes, consultez À propos des contextes de minifiltre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Cette routine est disponible sur Windows Vista et versions ultérieures.
Plateforme cible	Universal
En-tête	fltkernel.h (inclure Fltkernel.h)
Bibliothèque	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL