FltSupportsFileContextsEx, fonction (fltkernel.h)
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 être NULL.
[in, optional] Instance
Pointeur d’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 de retour
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 sinon.
Remarques
Les pilotes minifilter 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 minifilter ne peut pas attacher un 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 fichier 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 fichier. Au lieu de cela, le gestionnaire de filtres fournit la prise en charge du contexte de fichier à l’aide de 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 nullvalide est passée pour le paramètre Instance).
Si une valeur deNULL non est fournie pour le paramètre de l’instance de, 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 sinon.
Si le paramètre d’instance est NULL, FltSupportsFileContextsEx retourne TRUE uniquement si le système de fichiers prend en charge les contextes de fichier pour le fichier. Sinon, elle 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 fichier pour la pagination des fichiers.
Pour plus d’informations sur les contextes, consultez À propos des contextes minifilter.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Cette routine est disponible sur Windows Vista et versions ultérieures. |
| plateforme cible | Universel |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| bibliothèque | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |