NdisAllocateMemoryWithTagPriority 函式 (ndis.h)

發行項
02/26/2024

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 和更新版本支援。
目標平台	Universal
標頭	ndis.h (包括 Ndis.h)
程式庫	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	Irql_Miscellaneous_Function (ndis) 、 NdisAllocateMemoryWithTagPriority (ndis) 、NdisAllocateMemoryWithTagPriority_Cleanup (ndis) 、NdisAllocateMemoryWithTagPriority_InitFail (ndis)