Fonction FltRequestFileInfoOnCreateCompletion (fltkernel.h)
Un minifiltre appelle FltRequestFileInfoOnCreateCompletion pendant la précréation du fichier pour demander que le système 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 des fichiers dans une structure de QUERY_ON_CREATE_FILE_STAT_INFORMATION à des fins de récupération. |
| 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. |
| QoCFileUsnInformation (0x00000008) | S’il est défini, le système de fichiers stocke les informations USN dans une structure de QUERY_ON_CREATE_USN_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) |