Funzione NdisFreeMemoryWithTagPriority (ndis.h)

Articolo
08/07/2023

La funzione NdisFreeMemoryWithTagPriority rilascia memoria allocata con Funzione NdisAllocateMemoryWithTagPriority .

Sintassi

void NdisFreeMemoryWithTagPriority(
  [in] NDIS_HANDLE NdisHandle,
  [in] PVOID       VirtualAddress,
  [in] ULONG       Tag
);

Parametri

[in] NdisHandle

Gestione driver o istanza di NDIS ottenuta durante l'inizializzazione del chiamante. Si tratta dello stesso handle passato al driver Funzione NdisAllocateMemoryWithTagPriority . Ad esempio, un driver miniport può usare l'handle NDIS ottenuto dall'oggetto Funzione NdisMRegisterMiniportDriver o MiniportInitializeEx . Altri driver NDIS possono usare gli handle dalle funzioni seguenti:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[in] VirtualAddress

Puntatore all'indirizzo virtuale di base della memoria allocata. Questo indirizzo è stato restituito dal Funzione NdisAllocateMemoryWithTagPriority .

[in] Tag

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

Valore restituito

nessuno

Osservazioni

Poiché la memoria non memorizzata e la memoria contigua vengono rilasciate raramente finché il driver miniport allocato non viene scaricato, un chiamante di NdisFreeMemoryWithTagPriority è in genere in esecuzione in IRQL = PASSIVE_LEVEL per questi tipi di de-allocazioni. In ogni caso:

Quando un chiamante di NdisFreeMemoryWithTagPriority rilascia memoria contigua, deve essere in esecuzione in IRQL = PASSIVE_LEVEL.
Quando un chiamante di NdisFreeMemoryWithTagPriority rilascia memoria non memorizzata, deve essere in esecuzione in IRQL < DISPATCH_LEVEL.
Quando un chiamante di NdisFreeMemoryWithTagPriority rilascia memoria che non è contigua né non memorizzata, deve essere in esecuzione in IRQL <= DISPATCH_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.20 e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	ndis.h (includere Ndis.h)
Libreria	Ndis.lib
IRQL	Vedere La sezione Osservazioni.
Regole di conformità DDI	NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis)