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