Macro NdisFreeString (ndis.h)

Article
02/26/2024

La fonction NdisFreeString libère le stockage alloué par NdisInitializeString pour une chaîne mise en mémoire tampon.

Syntaxe

void NdisFreeString(
  [in]  String
);

Paramètres

[in] String

Valeur de type NDIS_STRING qui décrit la chaîne à libérer. Pour Windows 2000 et versions ultérieures, NDIS définit le type NDIS_STRING comme un type UNICODE_STRING .

Valeur de retour

None

Remarques

Un pilote NDIS appelle généralement la fonction NdisInitializeString pendant l’initialisation, par exemple pour configurer les noms passés aux fonctions de configuration NdisXxx. Pour chaque appel que le pilote effectue à NdisInitializeString, le pilote doit effectuer un appel correspondant à NdisFreeString. Lors de la libération des mémoires tampons de chaîne qui ont été allouées pendant l’initialisation, un pilote doit appeler NdisFreeString avant que la fonction d’initialisation du pilote retourne le contrôle.

NdisFreeString doit être utilisé uniquement pour libérer des mémoires tampons qui ont été allouées avec NdisInitializeString.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes existants dans NDIS 6.0 et versions ultérieures, mais les nouveaux pilotes doivent utiliser RtlFreeAnsiString ou RtlFreeUnicodeString à la place.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	Irql_Miscellaneous_Function(ndis)