FltRequestFileInfoOnCreateCompletion, fonction (fltkernel.h)
Un minifilter appelle FltRequestFileInfoOnCreateCompletion lors de la précréation du fichier pour demander que le système de fichiers stocke les informations de fichier pour la récupération pendant la création 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 le FLT_CALLBACK_DATA données de rappel représentant l’opération de création d’E/S.
InfoClassFlags
Indicateur du masque de bits indiquant le type d’informations de fichier que le système de fichiers doit stocker pour la récupération pendant la création post-création. Il peut s’agir de n’importe quelle combinaison des indicateurs suivants :
| Drapeau | Signification |
|---|---|
| QoCFileStatInformation (0x00000001) | S’il est défini, le système de fichiers stocke les informations statistiques des fichiers dans une structure QUERY_ON_CREATE_FILE_STAT_INFORMATION pour la récupération. |
| QoCFileLxInformation (0x00000002) | Si elle est définie, le système de fichiers stocke les informations de type Linux étendues dans une structure QUERY_ON_CREATE_FILE_LX_INFORMATION pour la récupération. |
| QoCFileEaInformation (0x00000004) | Si elle est définie, le système de fichiers stocke les attributs étendus (EA) dans une structure QUERY_ON_CREATE_EA_INFORMATION pour la récupération. |
| QoCFileUsnInformation (0x00000008) | Si elle est définie, le système de fichiers stocke les informations USN dans une structure QUERY_ON_CREATE_USN_INFORMATION pour la récupération. |
Valeur de retour
FltRequestFileInfoOnCreateCompletion pouvez retourner l’une des valeurs suivantes :
| Retourner le code | 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 dans laquelle 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 pendant la création de publication. Les performances d’un minifilter sont généralement meilleures quand elles demandent et récupèrent des informations de fichier de cette manière, plutôt que d’interroger les informations de fichier ultérieurement.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | fltkernel.h (include Fltkernel.h) |