Macro RtlCopyMemory (ntddstor.h)

A rotina RtlCopyMemory copia o conteúdo de um bloco de memória de origem para um bloco de memória de destino.

Sintaxe

void RtlCopyMemory(
   Destination,
   Source,
   Length
);

Parâmetros

Destination

Tipo de dados: void*. Um ponteiro para o bloco de memória de destino para o qual copiar os bytes.

Source

Tipo de dados: const void*. Um ponteiro para o bloco de memória de origem do qual copiar os bytes.

Length

Tipo de dados: size_t. O número de bytes a serem copiados da origem para o destino.

Retornar valor

Nenhum

Comentários

RtlCopyMemory é executado mais rápido que RtlMoveMemory. No entanto, RtlCopyMemory requer que o bloco de memória de origem, definido por Source e Length, não possa sobrepor o bloco de memória de destino, que é definido por Destino e Comprimento. Por outro lado, RtlMoveMemory manipula corretamente o caso em que os blocos de memória de origem e de destino se sobrepõem.

Novos drivers devem usar a rotina RtlCopyMemory em vez de RtlCopyBytes.

Os chamadores de RtlCopyMemory poderão estar em execução em qualquer IRQL se os blocos de memória de origem e de destino estiverem na memória do sistema nãopagada. Caso contrário, o chamador deverá estar em execução em IRQL <= APC_LEVEL.

Requisitos

Requisito	Valor
Cabeçalho	ntddstor.h

Confira também

RtlMoveMemory