Функция FillDeviceMemory

Статья
01/31/2024

Функция 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

Поделиться через