Funzione NdisAllocateMemoryWithTagPriority (ndis.h)

Articolo
02/29/2024

I driver NDIS chiamano la funzione NdisAllocateMemoryWithTagPriority per allocare un pool di memoria dal pool non di paging.

Sintassi

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

Parametri

[in] NdisHandle

Handle NDIS ottenuto dal chiamante durante l'inizializzazione. Ad esempio, un driver miniport può usare l'handle NDIS ottenuto dal Funzione NdisMRegisterMiniportDriver o MiniportInitializeEx . Altri driver NDIS possono usare gli handle delle funzioni seguenti:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[in] Length

Dimensione da allocare, in byte.

[in] Tag

Stringa, delimitata da virgolette singole, con un massimo di quattro caratteri, in genere specificata in ordine inverso. Il tag predefinito fornito da NDIS per questa chiamata è "maDN", ma il chiamante può eseguire l'override di questo valore predefinito specificando un valore esplicito.

[in] Priority

Importanza di questa richiesta. Per ulteriori informazioni, vedere ExAllocatePoolWithTagPriority.

Valore restituito

NdisAllocateMemoryWithTagPriority restituisce un puntatore a un indirizzo virtuale di base della memoria allocata oppure NULL se memoria non di paging sufficiente non è attualmente disponibile.

Commenti

Per liberare memoria allocata con NdisAllocateMemoryWithTagPriority, chiamare la funzione NdisFreeMemoryWithTagPriority o NdisFreeMemory .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	ndis.h (include Ndis.h)
Libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	Irql_Miscellaneous_Function(ndis), NdisAllocateMemoryWithTagPriority(ndis), NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis)