Fonction FltAllocateCallbackDataEx (fltkernel.h)

La routine FltAllocateCallbackDataEx alloue une structure de données de rappel et peut préallouer la mémoire pour des structures supplémentaires qu’un pilote de minifiltre peut utiliser pour lancer une demande d’E/S.

Syntaxe

NTSTATUS FLTAPI FltAllocateCallbackDataEx(
  [in]          PFLT_INSTANCE                    Instance,
  [in/optional] PFILE_OBJECT                     FileObject,
  [in]          FLT_ALLOCATE_CALLBACK_DATA_FLAGS Flags,
  [out]         PFLT_CALLBACK_DATA               *RetNewCallbackData
);

Paramètres

[in] Instance

Opaque instance pointeur vers le pilote minifiltre instance qui lance l’opération d’E/S. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

[in/optional] FileObject

Pointeur vers un objet de fichier à utiliser dans l’opération d’E/S. Ce paramètre est facultatif et peut être NULL. Définissez FileObject sur NULL s’il s’agit d’une opération CREATE.

[in] Flags

Valeur zéro ou indicateur suivant : FLT_ALLOCATE_CALLBACK_DATA_PREALLOCATE_ALL_MEMORY

Si cet indicateur est défini, la routine préalloue toute la mémoire nécessaire au gestionnaire de filtres pour les structures supplémentaires à utiliser dans une demande d’E/S.

[out] RetNewCallbackData

Pointeur vers une variable allouée par l’appelant qui reçoit l’adresse des données de rappel nouvellement allouées FLT_CALLBACK_DATA structure.

Valeur retournée

La routine FltAllocateCallbackDataEx retourne STATUS_SUCCESS en cas de réussite ou de STATUS_INSUFFICIENT_RESOURCES si la routine a rencontré un échec d’allocation de pool lors de la tentative d’allocation de la structure de données de rappel ou si l’indicateur FLT_ALLOCATE_CALLBACK_DATA_PREALLOCATE_ALL_MEMORY est défini et que la mémoire supplémentaire n’a pas pu être allouée.

Remarques

Si l’indicateur FLT_ALLOCATE_CALLBACK_DATA_PREALLOCATE_ALL_MEMORY est défini, la routine alloue toute la mémoire nécessaire à l’utilisation d’autres structures de gestionnaire de filtres dans une demande d’E/S suivante. L’utilisation de cet indicateur permet à un minifiltre de préallouer une ou plusieurs structures de données de rappel à utiliser pour émettre des demandes d’E/S dans des conditions de mémoire faible ou dans des situations où la récupération après un échec d’allocation de mémoire peut s’avérer compliquée.

Configuration requise

Voir aussi

FLT_CALLBACK_DATA

FltAllocateCallbackData