NdisFreeMemoryWithTagPriority 函式 (ndis.h)

NdisFreeMemoryWithTagPriority 函式會釋放已配置給 的記憶體 NdisAllocateMemoryWithTagPriority 函式

語法

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

參數

[in] NdisHandle

在呼叫端初始化期間取得的 NDIS 驅動程式或實例句柄。 這應該是驅動程序傳遞給的相同句柄 NdisAllocateMemoryWithTagPriority 函式 。 例如,迷你埠驅動程式可以使用從 取得的 NDIS 句柄 NdisMRegisterMiniportDriverMiniportInitializeEx 函 式。 其他 NDIS 驅動程式可以使用下列函式中的句柄:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

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

另請參閱

FilterAttach

MiniportInitializeEx

NdisAllocateMemoryWithTagPriority

NdisFRegisterFilterDriver

NdisMRegisterMiniportDriver

NdisOpenAdapterEx

NdisRegisterProtocolDriver