Функция NdisAllocateMemoryWithTagPriority (ndis.h)

Статья
08/07/2023

Драйверы 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 , если достаточный объем памяти в данный момент недоступен.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в 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)