Macro RtlCopyMemory (ntddstor.h)

La routine RtlCopyMemory copia il contenuto di un blocco di memoria di origine in un blocco di memoria di destinazione.

Sintassi

void RtlCopyMemory(
   Destination,
   Source,
   Length
);

Parametri

Destination

Tipo di dati: void*. Puntatore al blocco di memoria di destinazione in cui copiare i byte.

Source

Tipo di dati: const void*. Puntatore al blocco di memoria di origine da cui copiare i byte.

Length

Tipo di dati: size_t. Numero di byte da copiare dall'origine alla destinazione.

Valore restituito

nessuno

Osservazioni

RtlCopyMemory viene eseguito più velocemente di RtlMoveMemory. Tuttavia, RtlCopyMemory richiede che il blocco di memoria di origine, definito da Source e Length, non possa sovrapporsi al blocco di memoria di destinazione, definito da Destination e Length. RtlMoveMemory gestisce invece correttamente il caso in cui i blocchi di memoria di origine e di destinazione si sovrappongono.

I nuovi driver devono usare la routine RtlCopyMemory anziché RtlCopyBytes.

I chiamanti di RtlCopyMemory possono essere eseguiti in qualsiasi IRQL se i blocchi di memoria di origine e di destinazione si trovano nella memoria di sistema non in pagine. In caso contrario, il chiamante deve essere in esecuzione in IRQL <= APC_LEVEL.

Requisiti

Vedi anche

RtlMoveMemory