RtlCopyMemory-Makro (ntddstor.h)
Die RtlCopyMemory Routine kopiert den Inhalt eines Quellspeicherblocks in einen Zielspeicherblock.
Syntax
void RtlCopyMemory(
Destination,
Source,
Length
);
Parameter
Destination
Datentyp: void*. Ein Zeiger auf den Zielspeicherblock, in den die Bytes kopiert werden sollen.
Source
Datentyp: const void*. Ein Zeiger auf den Quellspeicherblock, aus dem die Bytes kopiert werden sollen.
Length
Datentyp: size_t. Die Anzahl der Bytes, die von der Quelle an das Ziel kopiert werden sollen.
Rückgabewert
Nichts
Bemerkungen
RtlCopyMemory schneller als RtlMoveMemory. RtlCopyMemory- erfordert jedoch, dass der Quellspeicherblock, der durch Source und Lengthdefiniert wird, den Zielspeicherblock nicht überlappen kann, der durch Zielspeicherblock und Lengthdefiniert wird. Im Gegensatz dazu behandelt RtlMoveMem ory korrekt den Fall, in dem sich die Quell- und Zielspeicherblöcke überlappen.
Neue Treiber sollten die RtlCopyMemory Routine anstelle von RtlCopyBytesverwenden.
Aufrufer von RtlCopyMemory- können bei jedem IRQL ausgeführt werden, wenn sich die Quell- und Zielspeicherblöcke im nicht seitenseitigen Systemspeicher befinden. Andernfalls muss der Aufrufer unter IRQL <= APC_LEVEL ausgeführt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ntddstor.h |