Partager via


Macro RtlCopyMemory (ntddstor.h)

La routine RtlCopyMemory copie le contenu d’un bloc de mémoire source vers 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

Aucun

Remarques

RtlCopyMemory s’exécute plus rapidement que RtlMoveMemory. Toutefois, RtlCopyMemory exige que le bloc de mémoire source, défini par source et longueur, ne puisse pas chevaucher le bloc de mémoire de destination, défini par de destination et Longueur. En revanche, RtlMoveMemory gère correctement le cas dans lequel 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 s’exécuter à n’importe quel runtime IRQL si les blocs de mémoire source et de destination se trouvent dans la mémoire système non paginé. Dans le cas contraire, l’appelant doit s’exécuter à l'<IRQL = APC_LEVEL.

Exigences

Exigence Valeur
d’en-tête ntddstor.h

Voir aussi

RtlMoveMemory