Freigeben über


NdisFreeString-Makro (ndis.h)

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)

Weitere Informationen

ANSI_STRING

DriverEntry of NDIS Protocol Drivers

MiniportInitializeEx

NdisOpenAdapterEx

NdisRegisterProtocolDriver

ProtocolBindAdapterEx

RtlInitString

RtlInitUnicodeString

RtlUnicodeStringToAnsiString

UNICODE_STRING