Freigeben über


NdisAllocateMemoryWithTagPriority-Funktion (ndis.h)

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)

Weitere Informationen

ExAllocatePoolWithTagPriority

FilterAttach

MiniportInitializeEx

NdisAllocateMemoryWithTag

NdisFRegisterFilterDriver

NdisFreeMemory

NdisFreeMemoryWithTagPriority

NdisMRegisterMiniportDriver

NdisOpenAdapterEx

NdisRegisterProtocolDriver