FltCheckAndGrowNameControl, fonction (fltkernel.h)

Article
02/06/2025

La routine FltCheckAndGrowNameControl vérifie si la mémoire tampon d’une structure FLT_NAME_CONTROL est suffisamment grande pour contenir le nombre spécifié d’octets. Si ce n’est pas le cas, FltCheckAndGrowNameControl la 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 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 de retour

FltCheckAndGrowNameControl retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Retourner le code	Description
STATUS_INSUFFICIENT_RESOURCES	La mémoire disponible dans le pool libre est insuffisante pour satisfaire la demande.

Remarques

Les pilotes Minifilter ne doivent pas tenter de libérer ou de remplacer la mémoire tampon dans le Nom membre d’une structure FLT_NAME_CONTROL directement. Au lieu de cela, les pilotes minifilter doivent appeler FltCheckAndGrowNameControl pour obtenir une mémoire tampon de nom 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 allouée par le système plus grande. FltCheckAndGrowNameControl copie le contenu de l’ancienne mémoire tampon dans la nouvelle mémoire tampon et libère l’ancienne mémoire tampon.

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