Функция 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 или функции NdisFreeMemor y.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.0 и более поздних версиях.
целевая платформа	Всеобщий
заголовка	ndis.h (include Ndis.h)
библиотеки	Ndis.lib
IRQL	<= DISPATCH_LEVEL
правил соответствия DDI	Irql_Miscellaneous_Function(ndis), NdisAllocateMemoryWithTagPriority(ndis), NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis)