Fonction FltRetrieveFileInfoOnCreateCompletionEx (fltkernel.h)

FltRetrieveFileInfoOnCreateCompletionEx interroge les informations de fichier spécifiées à l’achèvement de la création du fichier.

Syntaxe

NTSTATUS FLTAPI FltRetrieveFileInfoOnCreateCompletionEx(
  [in]  PFLT_FILTER        Filter,
  [in]  PFLT_CALLBACK_DATA Data,
  [in]  ULONG              InfoClass,
  [out] PULONG             RetInfoSize,
  [out] PVOID              *RetInfoBuffer
);

Paramètres

[in] Filter

Pointeur de filtre opaque qui identifie de manière unique le pilote de minifiltre. Il est retourné par FltRegisterFilter et reste constant tant que le pilote de minifiltre est chargé.

[in] Data

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

[in] InfoClass

Indicateur qui indique le type d’informations de fichier à retourner. Notez que les indicateurs ne peuvent pas être combinés. Peut avoir l’une des valeurs suivantes :

[out] RetInfoSize

Pointeur vers un ULONG qui reçoit la taille, en octets, de la mémoire tampon vers laquelle pointe RetInfoBuffer .

[out] RetInfoBuffer

Reçoit un pointeur vers la structure InfoClass demandée. Si le système de fichiers est en mesure de traiter la demande mais ne trouve pas les informations de fichier demandées, ce paramètre a la valeur NULL.

Valeur retournée

Remarques

FltRequestFileInfoOnCreateCompletion et FltRetrieveFileInfoOnCreateCompletionEx permettent à un minifiltre d’obtenir des informations sur un fichier lors de la création d’un fichier, évitant ainsi le coût de performances d’une requête ultérieure qui nécessiterait une traversée de pile.

• En précréation, le minifiltre effectue un appel à FltRequestFileInfoOnCreateCompletion avec une combinaison d’entrées InfoClassFlags qui identifient les informations demandées.
• Le système de fichiers alloue la ou les structures appropriées et remplit les informations demandées, si prise en charge, pendant qu’il traite la création.
• Après la création, le minifiltre appelle FltRetrieveFileInfoOnCreateCompletionEx pour obtenir les informations demandées dans l’appel de précréation. Si le minifiltre a demandé plusieurs types d’informations, il doit appeler FltRetrieveFileInfoOnCreateCompletionEx une fois pour chaque type d’informations. Par exemple :

// Pre-create:
NTSTATUS status;
status = FltRequestFileInfoOnCreateCompletion( Filter,
                                               CallbackData,
                                               QoCFileStatInformation
                                                | QoCFileLxInformation
                                                | QoCFileEaInformation 
                                                | QoCFileUsnInformation );

// Post-create:
NTSTATUS status;
ULONG fileStatSize, fileLxSize, fileEaSize;
QUERY_ON_CREATE_FILE_STAT_INFORMATION* fileStatInfo;
QUERY_ON_CREATE_FILE_LX_INFORMATION* fileLxInfo;
QUERY_ON_CREATE_EA_INFORMATION* fileEaInfo;
QUERY_ON_CREATE_USN_INFORMATION* fileUsnInfo;
QUERY_ON_CREATE_SECURITY_INFORMATION* fileSecurityInfo;

status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileStatInformation,
                                                  &fileStatSize,
                                                  &fileStatInfo );
status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileLxInformation,
                                                  &fileLxSize,
                                                  &fileLxInfo );
status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileEaInformation, 
                                                  &fileEaSize, 
                                                  &fileEaInfo );
status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileUsnInformation, 
                                                  &fileUsnInfo, 
                                                  &fileUsnInfo );
status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileSecurityInformation,
                                                  &fileSecurityInfo,
                                                  &fileSecurityInfo);

Une fois que FltRetrieveFileInfoOnCreateCompletionEx est retourné, un minifiltre peut écrire dans la mémoire tampon vers laquelle pointe RetInfoBuffer . Tous les filtres situés au-dessus de ce minifiltre verront les modifications s’ils appellent FltRetrieveFileInfoOnCreateCompletionEx sur le type d’informations modifié.

Configuration requise

Voir aussi

ECP_LIST

FLT_CALLBACK_DATA

FltRequestFileInfoOnCreateCompletion

QUERY_ON_CREATE_EA_INFORMATION

QUERY_ON_CREATE_FILE_STAT_INFORMATION

QUERY_ON_CREATE_FILE_LX_INFORMATION