NdisFreeString-Makro (ndis.h)

Artikel
02/29/2024

Die NdisFreeString-Funktion gibt Speicher frei, der von NdisInitializeString für eine gepufferte Zeichenfolge zugeordnet wurde.

Syntax

void NdisFreeString(
  [in]  String
);

Parameter

[in] String

Ein NDIS_STRING Typwert, der die freizugebende Zeichenfolge beschreibt. Für Windows 2000 und höher definiert NDIS den NDIS_STRING Typ als UNICODE_STRING Typ.

Rückgabewert

Keine

Bemerkungen

Ein NDIS-Treiber ruft in der Regel die NdisInitializeString-Funktion während der Initialisierung auf, z. B. zum Einrichten von Namen, die an die NdisXxx-Konfigurationsfunktionen übergeben werden. Für jeden Aufruf, den der Treiber an NdisInitializeString sendet, muss der Treiber einen entsprechenden Aufruf von NdisFreeString durchführen. Beim Freigeben von Zeichenfolgenpuffern, die während der Initialisierung zugeordnet wurden, muss ein Treiber NdisFreeString aufrufen, bevor die Initialisierungsfunktion des Treibers die Steuerung zurückgibt.

NdisFreeString darf nur zum Freigeben von Puffern verwendet werden, die mit NdisInitializeString zugeordnet wurden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Wird für vorhandene Treiber in NDIS 6.0 und höher unterstützt, aber neue Treiber sollten stattdessen RtlFreeAnsiString oder RtlFreeUnicodeString verwenden.
Zielplattform	Desktop
Kopfzeile	ndis.h (include Ndis.h)
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Miscellaneous_Function(ndis)