Macro NdisFreeString (ndis.h)
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) |