Функция MmAllocateNonCachedMemory (ntddk.h)

Подпрограмма MmAllocateNonCachedMemory выделяет диапазон виртуальных адресов, не кэшируемых и выровненных в кэше памяти.

Синтаксис

PVOID MmAllocateNonCachedMemory(
  [in] SIZE_T NumberOfBytes
);

Параметры

[in] NumberOfBytes

Задает размер в байтах выделенного диапазона.

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

Если запрошенная память не может быть выделена, возвращаемое значение NULL. В противном случае это базовый виртуальный адрес выделенного диапазона.

Замечания

MmAllocateNonCachedMemory можно вызвать из подпрограммы DriverEntry, чтобы выделить не кэшированный блок виртуальной памяти для различных буферов, относящихся к устройству. Функция всегда возвращает полный размер страницы виртуальной памяти, неупакованной памяти, независимо от запрошенного размера выделения.

Не кэшированные выделения выравниваются по целочисленной части размера строки кэша данных процессора, чтобы предотвратить проблемы с кэшем и согласованности.

Страницы физической памяти, которые MmAllocateNonCachedMemory возвращаются, как правило, не являются смежными страницами.

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

Требования

См. также

AllocateCommonBuffer

KeGetDcacheFillSize

MmAllocateContiguousMemory

MmAllocateContiguousMemorySpecifyCache

MmFreeNonCachedMemory