Partager via


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)

Voir aussi

ANSI_STRING

DriverEntry des pilotes de protocole NDIS

MiniportInitializeEx

NdisOpenAdapterEx

NdisRegisterProtocolDriver

ProtocolBindAdapterEx

RtlInitString

RtlInitUnicodeString

RtlUnicodeStringToAnsiString

UNICODE_STRING