Fonction FltCheckAndGrowNameControl (fltkernel.h)

Article
02/29/2024

La routine FltCheckAndGrowNameControl vérifie si la mémoire tampon d’une structure FLT_NAME_CONTROL est suffisamment grande pour contenir le nombre d’octets spécifié. Si ce n’est pas le cas, FltCheckAndGrowNameControl le remplace par une mémoire tampon allouée par le système plus grande.

Syntaxe

NTSTATUS FLTAPI FltCheckAndGrowNameControl(
  [in, out] PFLT_NAME_CONTROL NameCtrl,
  [in]      USHORT            NewSize
);

Paramètres

[in, out] NameCtrl

Pointeur vers une structure de FLT_NAME_CONTROL contenant des informations de nom de fichier.

[in] NewSize

Taille requise, en octets, de la nouvelle mémoire tampon de contrôle de nom.

Valeur retournée

FltCheckAndGrowNameControl retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, telle que la suivante :

Code de retour	Description
STATUS_INSUFFICIENT_RESOURCES	La mémoire disponible dans le pool libre est insuffisante pour répondre à la demande.

Remarques

Les pilotes Minifilter ne doivent pas tenter de libérer ou de remplacer directement la mémoire tampon dans le membre Name d’une structure FLT_NAME_CONTROL . Au lieu de cela, les pilotes minifilter doivent appeler FltCheckAndGrowNameControl pour obtenir une mémoire tampon de noms plus grande.

Si la taille, en octets, de la mémoire tampon dans la structure NameCtrl est inférieure à la valeur du paramètre NewSize , FltCheckAndGrowNameControl la remplace par une mémoire tampon plus grande allouée par le système. FltCheckAndGrowNameControl copie le contenu de l’ancienne mémoire tampon dans la nouvelle et libère l’ancienne mémoire tampon.

Si la taille, en octets, de la mémoire tampon dans la structure NameCtrl est supérieure ou égale à la valeur du paramètre NewSize , FltCheckAndGrowNameControl retourne STATUS_SUCCESS et ne remplace pas la mémoire tampon.