NdisFreeMemoryWithTagPriority 函式 (ndis.h)
NdisFreeMemoryWithTagPriority 函式會釋放已配置給 的記憶體 NdisAllocateMemoryWithTagPriority 函式 。
語法
void NdisFreeMemoryWithTagPriority(
[in] NDIS_HANDLE NdisHandle,
[in] PVOID VirtualAddress,
[in] ULONG Tag
);
參數
[in] NdisHandle
在呼叫端初始化期間取得的 NDIS 驅動程式或實例句柄。 這應該是驅動程序傳遞給的相同句柄 NdisAllocateMemoryWithTagPriority 函式 。 例如,迷你埠驅動程式可以使用從 取得的 NDIS 句柄 NdisMRegisterMiniportDriver 或 MiniportInitializeEx 函 式。 其他 NDIS 驅動程式可以使用下列函式中的句柄:
[in] VirtualAddress
配置記憶體之基底虛擬位址的指標。 此位址是由 傳回的 NdisAllocateMemoryWithTagPriority 函式 。
[in] Tag
以單引號分隔的字串,最多四個字元,通常會以反轉順序指定。 此呼叫的 NDIS 提供的預設標籤是 'maDN',但呼叫端可以藉由提供明確的值來覆寫此預設值。
傳回值
無
備註
由於在配置迷你埠驅動程式卸載之前,很少釋放非快取記憶體和連續記憶體,因此 NdisFreeMemoryWithTagPriority 的呼叫端通常會在 IRQL = PASSIVE_LEVEL針對這些類型的取消配置執行。 在任何情況下:
- 當 NdisFreeMemoryWithTagPriority 的呼叫端釋放連續記憶體時,它必須在 IRQL = PASSIVE_LEVEL執行。
- 當 NdisFreeMemoryWithTagPriority 的呼叫端釋放非快取記憶體時,它必須在 IRQL < DISPATCH_LEVEL 上執行。
- 當 NdisFreeMemoryWithTagPriority 的呼叫端釋放不連續或非快取的記憶體時,它必須在 IRQL <= DISPATCH_LEVEL執行。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.20 和更新版本支援。 |
目標平台 | Universal |
標頭 | ndis.h (包含 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | 請參閱一節。 |
DDI 合規性規則 | NdisAllocateMemoryWithTagPriority_Cleanup (ndis) ,NdisAllocateMemoryWithTagPriority_InitFail (ndis) |