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

Статья
05/23/2024

Функция RtlZeroDeviceMemory — это удобная оболочка для RtlFillDeviceMemory.

Синтаксис

volatile void * RtlZeroDeviceMemory(
  [out] volatile void *Destination,
  [in]  size_t        Length
);

Параметры

[out] Destination

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

[in] Length

Размер блока памяти для заполнения нулями в байтах.

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

Возвращает значение Destination.

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

Пример

// In this scenario we are setting data on memory mapped
// as "device memory" (for example, memory not backed by RAM) to the value zero. On
// some platforms like ARM64, device memory cannot tolerate
// memory accesses that are not naturally aligned (for example, a 4-byte
// load must be 4-byte aligned). Functions like memset, RtlFillMemory,
// and even RtlFillVolatileMemory may perform unaligned memory accesses
// because it is typically faster to do this.
// To ensure only naturally aligned accesses happen, use RtlFillDeviceMemory.
//
// RtlZeroDeviceMemory is an wrapper around RtlFillDeviceMemory that sets the memory
// to zero.

RtlZeroDeviceMemory(DeviceMemoryBuffer, 100);

Требования

Требование	Значение
Заголовок	wdm.h (включая Wdm.h)
Библиотека	volatileaccessk.lib (режим ядра), volatileaccessu.lib (пользовательский режим)

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

RtlFillDeviceMemory

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