Функция FillDeviceMemory

  • Статья

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

Важно!

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

Параметры

Назначение Param [out]

Указатель на начальный адрес блока памяти для заполнения.

Длина param [in]

Размер блока памяти для заполнения в байтах. Это значение должно быть меньше размера буфера назначения.

Param Fill [in]

Значение байта, с помощью которого заполняется блок памяти.

Синтаксис

volatile void*
  FillDeviceMemory (
    _Out_writes_bytes_all_(Length) volatile void* Destination,
    SIZE_T Length,
    INT Fill
  );

Замечания

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

  • API не распознается как встроенный компилятор, поэтому компилятор никогда не оптимизирует вызов (полностью или замените вызов эквивалентной последовательностью инструкций). Это отличается от FillMemory, которое зависит от различных оптимизаций компилятора.
  • После завершения вызова буфер перезаписан с требуемым значением. Доступ к памяти этой функции выполняется только в функции (т. е. компилятор не может перемещать доступ к памяти из этой функции).
  • API может выполнять неуправляемый доступ к памяти только в том случае, если ЦП поддерживает неуправляемый доступ к памяти устройства. Если ЦП не поддерживает неуправляемый доступ к памяти устройства, будут выполнены только выровненные доступы.
  • API может получить доступ к расположениям памяти более одного раза в рамках своей операции.

Примечание.

Эта функция гарантирует, что требования ЦП к доступу к памяти, сопоставленной с памятью устройства, соблюдаются. Если у конкретного устройства есть собственные требования к доступу, эта функция не должна использоваться (и вместо этого разработчик должен реализовать собственные функции доступа). Например, эта функция не гарантирует размер созданного доступа к памяти (если только ЦП не применяет эти требования).

Примечание.

Эта функция работает во всех версиях Windows, а не только на последних версиях. Чтобы получить объявление функции из заголовка winbase.h , необходимо использовать последний пакет SDK. Вам также нужна библиотека (volatileaccessu.lib) из последнего пакета SDK. Однако результирующий двоичный файл будет работать в более ранних версиях Windows.

Пример

// In this scenario we are setting data on memory mapped
// as "device memory" (i.e. memory not backed by RAM). On
// some platforms like ARM64, device memory cannot tolerate
// memory accesses that are not naturally aligned (i.e. a 4-byte
// load must be 4-byte aligned). Functions like memset, FillMemory,
// and even FillVolatileMemory may perform unaligned memory accesses
// because it is typically faster to do this.
// To ensure only naturally aligned accesses happen, use FillDeviceMemory.

FillDeviceMemory(DeviceMemoryBuffer, 100, 0xAA);

Requirements

Минимальный поддерживаемый клиент: сборка предварительной версии Windows 11 Insider Preview ТБ D

Заголовок: winbase.h (включая Winbase.h)

Библиотека режима ядра: volatileaccessk.lib

Библиотека пользовательского режима: volatileaccessu.lib

См. также