Macro RtlCopyMemory (wdm.h)

  • Article

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)

Voir aussi

RtlMoveMemory