Compartilhar via


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.

Valor de retorno

Nenhum

Observações

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

Os novos drivers devem usar a rotina de rtlCopyMemory em vez de rtlCopyBytes.

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

Requisitos

Requisito Valor
cabeçalho ntddstor.h

Consulte também

rtlMoveMemory