NdisAllocateMemoryWithTagPriority-Funktion (ndis.h)

Artikel
02/26/2024

NDIS-Treiber rufen die NdisAllocateMemoryWithTagPriority-Funktion auf, um einen Pool mit Arbeitsspeicher aus dem nicht ausgelagerten 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 abgerufen hat. Ein Miniporttreiber kann beispielsweise das NDIS-Handle verwenden, das er von der NdisMRegisterMiniportDriver oder MiniportInitializeEx-Funktion . Andere NDIS-Treiber können die Handles aus den folgenden Funktionen verwenden:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[in] Length

Die zuzuordnende Größe in Bytes.

[in] Tag

Eine durch einfache Anführungszeichen getrennte Zeichenfolge 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 diesen Standardwert überschreiben, 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 virtuelle Basisadresse des zugewiesenen Arbeitsspeichers oder NULL zurück, wenn derzeit kein ausreichend nicht ausgestellter Arbeitsspeicher verfügbar ist.

Hinweise

Um Arbeitsspeicher freizugeben, der mit NdisAllocateMemoryWithTagPriority zugewiesen wurde, rufen Sie die Funktion NdisFreeMemoryWithTagPriority oder NdisFreeMemory auf.

Anforderungen

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