Fonction FltRequestFileInfoOnCreateCompletion (fltkernel.h)

  • Article

Un minifiltre appelle FltRequestFileInfoOnCreateCompletion pendant la précréation du fichier pour demander que le gestionnaire de fichiers stocke les informations de fichier à récupérer lors de la post-création.

Syntaxe

NTSTATUS FLTAPI FltRequestFileInfoOnCreateCompletion(
  PFLT_FILTER        Filter,
  PFLT_CALLBACK_DATA Data,
  ULONG              InfoClassFlags
);

Paramètres

Filter

Pointeur de filtre opaque qui identifie de manière unique le pilote minifilter.

Data

Pointeur vers les données de rappel FLT_CALLBACK_DATA représentant l’opération de création d’E/S.

InfoClassFlags

Masque de bits indicateur indiquant le type d’informations de fichier que le système de fichiers doit stocker pour la récupération lors de la post-création. Il peut s’agir de n’importe quelle combinaison des indicateurs suivants :

Indicateur Signification
QoCFileStatInformation (0x00000001) S’il est défini, le système de fichiers stocke les informations statistiques sur les fichiers dans une structure de QUERY_ON_CREATE_FILE_STAT_INFORMATION à des fins d’extraction.
QoCFileLxInformation (0x00000002) S’il est défini, le système de fichiers stocke des informations étendues de type Linux dans une structure de QUERY_ON_CREATE_FILE_LX_INFORMATION à des fins de récupération.
QoCFileEaInformation (0x00000004) S’il est défini, le système de fichiers stocke les attributs étendus (EA) dans une structure QUERY_ON_CREATE_EA_INFORMATION à des fins de récupération.

Valeur retournée

FltRequestFileInfoOnCreateCompletion peut retourner l’une des valeurs suivantes :

Code de retour Description
STATUS_SUCCESS Le système de fichiers a correctement stocké les informations de fichier demandées.
STATUS_INSUFFICIENT_RESOURCES FltRequestFileInfoOnCreateCompletion n’a pas pu allouer suffisamment de mémoire pour stocker les informations de fichier demandées.
STATUS_INVALID_PARAMETER_2 L’objet de données de rappel fourni n’était pas une opération de création basée sur IRP.

Remarques

Le minifilter peut récupérer les informations de fichier en appelant FltRetrieveFileInfoOnCreateCompletionEx ou FltRetrieveFileInfoOnCreateCompletion lors de la post-création. Les performances d’un minifiltre sont généralement meilleures lorsqu’il demande et récupère des informations de fichier de cette manière, plutôt que d’interroger les informations de fichier ultérieurement.

Configuration requise

Condition requise Valeur
En-tête fltkernel.h (inclure Fltkernel.h)

Voir aussi

FLT_CALLBACK_DATA

FltRetrieveFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx