Funzione NdisFreeMemoryWithTagPriority (ndis.h)
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
Handle di istanza o driver NDIS ottenuto durante l'inizializzazione del chiamante. Deve essere lo stesso handle passato dal driver al funzione NdisAllocateMemoryWithTagPriority. Ad esempio, un driver miniport può usare l'handle NDIS ottenuto dal NdisMRegisterMiniportDriver o funzione MiniportInitializeEx. Altri driver NDIS possono usare gli handle delle funzioni seguenti:
[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 un massimo di quattro caratteri, in genere specificato in ordine inverso. Il tag predefinito fornito da NDIS per questa chiamata è "maDN", ma il chiamante può eseguire l'override di questa impostazione predefinita specificando un valore esplicito.
Valore restituito
Nessuno
Osservazioni
Poiché la memoria non memorizzata nella cache 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 nella cache, deve essere in esecuzione in irQL < DISPATCH_LEVEL.
- Quando un chiamante di NdisFreeMemoryWithTagPriority rilascia memoria non contigua né non memorizzata, deve essere in esecuzione in IRQL <= DISPATCH_LEVEL.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato in NDIS 6.20 e versioni successive. |
| piattaforma di destinazione | Universale |
| intestazione | ndis.h (include Ndis.h) |
| libreria | Ndis.lib |
| IRQL | Vedere la sezione Osservazioni. |
| regole di conformità DDI | NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis) |