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) |