Condividi tramite


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 origine e Lunghezza, non possa sovrapporsi al blocco di memoria di destinazione, definito da di destinazione e Length. Al contrario, RtlMoveMemory gestisce 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 in memoria di sistema non di paging. In caso contrario, il chiamante deve essere in esecuzione in IRQL <= APC_LEVEL.

Fabbisogno

Requisito Valore
intestazione ntddstor.h

Vedere anche

RtlMoveMemory