NdisAllocateMemoryWithTagPriority-Funktion (ndis.h)

NDIS-Treiber rufen die NdisAllocateMemoryWithTagPriority-Funktion auf, um einen Speicherpool aus dem nicht seitenfreien Pool zuzuweisen.

Syntax

PVOID NdisAllocateMemoryWithTagPriority(
  [in] NDIS_HANDLE      NdisHandle,
  [in] UINT             Length,
  [in] ULONG            Tag,
  [in] EX_POOL_PRIORITY Priority
);

Parameter

[in] NdisHandle

Ein NDIS-Handle, das der Aufrufer während der Initialisierung erhalten hat. Ein Miniporttreiber kann z. B. den NDIS-Handle verwenden, den er aus dem NdisMRegisterMiniportDriver oder MiniportInitializeEx-Funktion . Andere NDIS-Treiber können die Ziehpunkte aus den folgenden Funktionen verwenden:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[in] Length

Die größe, die in Bytes zugewiesen werden soll.

[in] Tag

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

[in] Priority

Die Bedeutung dieser Anforderung. Weitere Informationen finden Sie unter ExAllocatePoolWithTagPriority.

Rückgabewert

NdisAllocateMemoryWithTagPriority gibt einen Zeiger auf eine Basis-virtuelle Adresse des zugewiesenen Speichers oder NULL zurück, wenn ausreichend nichtpaged Arbeitsspeicher zurzeit nicht verfügbar ist.

Hinweise

Rufen Sie die Funktion NdisFreeMemoryWithTagPriority auf, um Speicherplatz freizugeben, der mit NdisAllocateMemoryWithTagPriority oder NdisFreeMemory zugewiesen wurde.

Anforderungen

   
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.0 und höher.
Zielplattform Universell
Header ndis.h (include Ndis.h)
Bibliothek Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln Irql_Miscellaneous_Function(ndis), NdisAllocateMemoryWithTagPriority(ndis), NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis)

Weitere Informationen

ExAllocatePoolWithTagPriority

FilterAttach

MiniportInitializeEx

NdisAllocateMemoryWithTag

NdisFRegisterFilterDriver

NdisFreeMemory

NdisFreeMemoryWithTagPriority

NdisMRegisterMiniportDriver

NdisOpenAdapterEx

NdisRegisterProtocolDriver