Функция NdisAllocateMemoryWithTagPriority (ndis.h)
Драйверы 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 могут использовать дескрипторы из следующих функций:
[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) |