Share via

Макрос RtlCopyMemory (ntddstor.h)

  • Статья

Подпрограмма RtlCopyMemory копирует содержимое исходного блока памяти в целевой блок памяти.

Синтаксис

void RtlCopyMemory(
   Destination,
   Source,
   Length
);

Параметры

Destination

Тип данных: void*. Указатель на целевой блок памяти, в который копируются байты.

Source

Тип данных: const void*. Указатель на исходный блок памяти для копирования байтов.

Length

Тип данных: size_t. Число байтов для копирования из источника в место назначения.

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

None

Remarks

RtlCopyMemory работает быстрее , чем RtlMoveMemory. Однако для RtlCopyMemory требуется, чтобы исходный блок памяти, определенный в параметрах Source и Length, не перекрывал целевой блок памяти, определенный в параметрах Назначение и Длина. В отличие от этого, RtlMoveMemory правильно обрабатывает случай, когда исходный и целевой блоки памяти перекрываются.

Новые драйверы должны использовать подпрограмму RtlCopyMemory вместо RtlCopyBytes.

Вызывающие элементы RtlCopyMemory могут выполняться в любом irQL, если исходный и целевой блоки памяти находятся в системной памяти без загрузки. В противном случае вызывающий объект должен выполняться в irQL <= APC_LEVEL.

Требования

Требование Значение
Заголовок ntddstor.h

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

RtlMoveMemory