NdisAllocateMemoryWithTagPriority 函式（ndis.h）

發行項
02/07/2025

NDIS 驅動程式會呼叫 NdisAllocateMemoryWithTagPriority 函式，以從非分頁集區配置記憶體集區。

語法

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

參數

[in] NdisHandle

在初始化期間取得呼叫端的 NDIS 句柄。例如，迷你埠驅動程式可以使用從取得的 NDIS 句柄 NdisMRegisterMiniportDriver 或 MiniportInitializeEx 函式。其他 NDIS 驅動程式可以使用下列函式中的句柄：

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[in] Length

要配置的大小，以位元組為單位。

[in] Tag

以單引號分隔的字串，最多四個字元，通常會以反轉順序指定。此呼叫的 NDIS 提供的預設標籤是 'maDN'，但呼叫端可以藉由提供明確的值來覆寫此預設值。

[in] Priority

此要求的重要性。如需詳細資訊，請參閱 ExAllocatePoolWithTagPriority。

傳回值

NdisAllocateMemoryWithTagPriority 會傳回已配置記憶體之基底虛擬位址的指標，或 NULL 目前無法使用足夠的非分頁記憶體。

言論

若要釋放配置 NdisAllocateMemoryWithTagPriority的記憶體，請呼叫 NdisFreeMemoryWithTagPriority 或 NdisFreeMemory 函式。

要求

要求	價值
最低支援的用戶端	NDIS 6.0 和更新版本支援。
目標平臺	普遍
標頭	ndis.h （包括 Ndis.h）
連結庫	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	Irql_Miscellaneous_Function（ndis）， NdisAllocateMemoryWithTagPriority（ndis）， NdisAllocateMemoryWithTagPriority_Cleanup（ndis）， NdisAllocateMemoryWithTagPriority_InitFail（ndis）