Copies the contents of a source memory block to a destination memory block, and supports overlapping source and destination memory blocks.
Syntax
VOID RtlMoveMemory(
_Out_ VOID UNALIGNED *Destination,
_In_ const VOID UNALIGNED *Source,
_In_ SIZE_T Length
);
Parameters
Destination [out]
A pointer to the destination memory block to copy the bytes to.
Source [in]
A pointer to the source memory block to copy the bytes from.
Length [in]
The number of bytes to copy from the source to the destination.
Return value
None
Remarks
The source memory block, which is defined by Source and Length, can overlap the destination memory block, which is defined by Destination and Length.
The RtlCopyMemory routine runs faster than RtlMoveMemory, but RtlCopyMemory requires that the source and destination memory blocks do not overlap.
Callers of RtlMoveMemory can be running at any IRQL if the source and destination memory blocks are in nonpaged system memory. Otherwise, the caller must be running at IRQL <= APC_LEVEL.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target platform | Universal |
| Header | Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h) |
| Library | Ntdll.lib |
| DLL | Ntdll.dll |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
