Функция MmAllocatePagesForMdlEx (wdm.h)

Подпрограмма MmAllocatePagesForMdlEx выделяет невыгремые страницы физической памяти для MDL.

Используйте эту подпрограмму вместо MmAllocatePagesForMdl.

Синтаксис

PMDL MmAllocatePagesForMdlEx(
  [in] PHYSICAL_ADDRESS    LowAddress,
  [in] PHYSICAL_ADDRESS    HighAddress,
  [in] PHYSICAL_ADDRESS    SkipBytes,
  [in] SIZE_T              TotalBytes,
  [in] MEMORY_CACHING_TYPE CacheType,
  [in] ULONG               Flags
);

Параметры

[in] LowAddress

Указывает физический адрес начала первого диапазона адресов, из которого могут поступать выделенные страницы. Если MmAllocatePagesForMdlEx не может выделить запрошенное количество байтов в первом диапазоне адресов, он выполняет итерацию по дополнительным диапазонам адресов, чтобы получить дополнительные страницы. При каждой итерации MmAllocatePagesForMdlEx добавляет значение SkipBytes к предыдущему начального адреса, чтобы получить начало следующего диапазона адресов.

[in] HighAddress

Указывает физический адрес конца первого диапазона адресов, из который могут поступать выделенные страницы.

[in] SkipBytes

Указывает количество байтов, которые необходимо пропустить с начала предыдущего диапазона адресов, из которых могут поступать выделенные страницы. SkipBytes должен быть целым числом, кратным размеру страницы виртуальной памяти, в байтах.

[in] TotalBytes

Указывает общее количество байтов, выделяемых для MDL.

[in] CacheType

Задает значение MEMORY_CACHING_TYPE , указывающее тип кэширования, разрешенного для запрошенной памяти.

[in] Flags

Задает флаги для этой операции. Присвойте этому параметру значение ноль или побитовое ЗНАЧЕНИЕ ИЛИ одного или нескольких из следующих битов флага MM_ALLOCATE_XXX :

Последние четыре элемента в предыдущем списке поддерживаются только в Windows 7 и более поздних версиях Windows.

Возвращаемое значение

MmAllocatePagesForMdlEx возвращает одно из следующих результатов:

Комментарии

По умолчанию страницы физической памяти, возвращаемые MmAllocatePagesForMdlEx , не являются смежными страницами. Начиная с Windows 7 вызывающие абоненты могут переопределить поведение этой подпрограммы по умолчанию, задав бит флага MM_ALLOCATE_PREFER_CONTIGUOUS или MM_ALLOCATE_REQUIRE_CONTIGUOUS_CHUNKS в параметре Flags .

MmAllocatePagesForMdlEx предназначен для драйверов в режиме ядра, которым не требуются соответствующие виртуальные адреса (т. е. им нужны физические страницы и не должны быть физически смежными), а также для драйверов режима ядра, которые могут значительно повысить производительность, если физическая память устройства выделяется в определенном диапазоне физических адресов (например, графики AGP карта).

В зависимости от того, какой объем физической памяти в настоящее время доступен в запрошенных диапазонах, MmAllocatePagesForMdlEx может возвращать MDL, описывающий меньше памяти, чем было запрошено. Подпрограмма также может возвращать значение NULL , если память не выделена. Вызывающий объект должен проверка объем памяти, фактически выделенный для MDL.

Вызывающий объект должен использовать MmFreePagesFromMdl , чтобы освободить страницы памяти, описанные в MDL, созданном MmAllocatePagesForMdlEx. После вызова MmFreePagesFromMdl вызывающий объект также должен вызвать ExFreePool , чтобы освободить память, выделенную для структуры MDL.

По умолчанию MmAllocatePagesForMdlEx заполняет выделенные страницы нулями. Вызывающий объект может указать флаг MM_DONT_ZERO_ALLOCATION, чтобы переопределить это значение по умолчанию и, возможно, повысить производительность.

Память, выделенная MmAllocatePagesForMdlEx , не инициализируется, если указать флаг MM_DONT_ZERO_ALLOCATION. Драйвер режима ядра должен сначала обнулить эту память, если драйвер собирается сделать память видимой для программного обеспечения пользовательского режима (чтобы избежать утечки потенциально привилегированного содержимого). Дополнительные сведения об этом флаге см. в разделе MM_ALLOCATE_XXX.

Максимальный объем памяти, который mmAllocatePagesForMdlEx может выделить в одном вызове, составляет (4 гигабайта — PAGE_SIZE). Подпрограмма может удовлетворить запрос на выделение для этой суммы, только если доступно достаточно страниц.

MmAllocatePagesForMdlEx выполняется в IRQL <= APC_LEVEL. Вызывающие mmAllocatePagesForMdlEx могут находиться на DISPATCH_LEVEL. Тем не менее вы можете повысить производительность драйвера, вызвав APC_LEVEL или ниже.

Требования

См. также раздел

ExFreePool

MEMORY_CACHING_TYPE

MmAllocatePagesForMdl

MmFreePagesFromMdl

MmMapLockedPages