Macro RtlCopyMemory (wdm.h)
La routine RtlCopyMemory copie le contenu d’un bloc de mémoire source dans un bloc de mémoire de destination.
Syntaxe
void RtlCopyMemory(
void* Destination,
const void* Source,
size_t Length
);
Paramètres
[out] Destination
Pointeur vers le bloc de mémoire de destination vers lequel copier les octets.
[in] Source
Pointeur vers le bloc de mémoire source à partir duquel copier les octets.
[in] Length
Nombre d’octets à copier de la source vers la destination.
Valeur de retour
None
Remarques
RtlCopyMemory s’exécute plus rapidement que RtlMoveMemory. Toutefois, RtlCopyMemory exige que le bloc de mémoire source, qui est défini par Source et Length, ne puisse pas chevaucher le bloc de mémoire de destination, qui est défini par Destination et Length. En revanche, RtlMoveMemory gère correctement le cas où les blocs de mémoire source et de destination se chevauchent.
Les nouveaux pilotes doivent utiliser la routine RtlCopyMemory au lieu de RtlCopyBytes.
Les appelants de RtlCopyMemory peuvent être en cours d’exécution à n’importe quel IRQL si les blocs de mémoire source et de destination se trouvent dans la mémoire système non pagée. Sinon, l’appelant doit être en cours d’exécution à IRQL <= APC_LEVEL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtDll.dll (mode utilisateur) ; NtosKrnl.exe (mode noyau) |
| IRQL | N’importe quel niveau (voir la section Remarques) |