Macro RtlCopyMemory (ntddstor.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(
   Destination,
   Source,
   Length
);

Paramètres

Destination

Type de données : void*. Pointeur vers le bloc de mémoire de destination vers lequel copier les octets.

Source

Type de données : const void*. Pointeur vers le bloc de mémoire source à partir duquel copier les octets.

Length

Type de données : size_t. Nombre d’octets à copier de la source vers la destination.

Valeur de retour

None

Remarques

RtlCopyMemory fonctionne 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 au niveau de n’importe quel IRQL si les blocs de mémoire source et de destination se trouvent dans la mémoire système non paginé. Sinon, l’appelant doit s’exécuter sur IRQL <= APC_LEVEL.

Configuration requise

Condition requise	Valeur
En-tête	ntddstor.h

Voir aussi

RtlMoveMemory