NdisFreeMemoryWithTagPriority-Funktion (ndis.h)

Artikel
02/07/2025

Der NdisFreeMemoryWithTagPriority- gibt Speicher frei, der der Funktion zugeordnet wurde. NdisAllocateMemoryWithTagPriority Funktion.

Syntax

void NdisFreeMemoryWithTagPriority(
  [in] NDIS_HANDLE NdisHandle,
  [in] PVOID       VirtualAddress,
  [in] ULONG       Tag
);

Parameter

[in] NdisHandle

Ein NDIS-Treiber oder Instanzhandle, das während der Initialisierung des Aufrufers abgerufen wurde. Dies sollte das gleiche Handle sein, das der Treiber an den NdisAllocateMemoryWithTagPriority Funktion. Beispielsweise kann ein Miniporttreiber den NDIS-Handle verwenden, den er aus dem NdisMRegisterMiniportDriver oder MiniportInitializeEx Funktion. Andere NDIS-Treiber können die Handles aus den folgenden Funktionen verwenden:

NdisRegisterProtocolDriver-

NdisOpenAdapterEx

NdisFRegisterFilterDriver-

FilterAttach-

[in] VirtualAddress

Ein Zeiger auf die virtuelle Basisadresse des zugewiesenen Speichers. Diese Adresse wurde von der NdisAllocateMemoryWithTagPriority Funktion.

[in] Tag

Eine Zeichenfolge, die durch einfache Anführungszeichen getrennt ist, mit bis zu vier Zeichen, die normalerweise in umgekehrter Reihenfolge angegeben sind. Das von NDIS bereitgestellte Standardtag für diesen Aufruf ist "maDN", aber der Aufrufer kann diese Standardeinstellung außer Kraft setzen, indem er einen expliziten Wert angibt.

Rückgabewert

Nichts

Bemerkungen

Da nicht zwischengespeicherter Speicher und zusammenhängender Speicher nur selten freigegeben werden, bis der zugeordnete Miniporttreiber entladen wird, wird ein Aufrufer von NdisFreeMemoryWithTagPriority in der Regel bei IRQL = PASSIVE_LEVEL für diese Arten von Dezuweisungen ausgeführt. In jedem Fall:

Wenn ein Aufrufer von NdisFreeMemoryWithTagPriority zusammenhängenden Speicher freigibt, muss er unter IRQL = PASSIVE_LEVEL ausgeführt werden.
Wenn ein Aufrufer von NdisFreeMemoryWithTagPriority nicht zwischengespeicherten Arbeitsspeicher freigibt, muss er bei IRQL-< DISPATCH_LEVEL ausgeführt werden.
Wenn ein Aufrufer von NdisFreeMemoryWithTagPriority Arbeitsspeicher freigibt, der weder zusammenhängend noch nicht zwischengespeichert ist, muss er bei IRQL <= DISPATCH_LEVEL ausgeführt werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.20 und höher.
Zielplattform-	Universal
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	Siehe Abschnitt "Hinweise".
DDI-Complianceregeln	NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis)