Macro RtlCopyMemory (wdm.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(
   void*       Destination,
   const void* Source,
   size_t      Length
);

Parâmetros

[out] Destination

Um ponteiro para o bloco de memória de destino para o qual copiar os bytes.

[in] Source

Um ponteiro para o bloco de memória de origem do qual copiar os bytes.

[in] Length

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 Destination e Length. Por outro lado, RtlMoveMemory manipula corretamente o caso em que os blocos de memória de origem e 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 destino estiverem na memória do sistema nãopagada. Caso contrário, o chamador deve estar em execução em IRQL <= APC_LEVEL.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtDll.dll (modo de usuário); NtosKrnl.exe (modo kernel)
IRQL Qualquer nível (consulte a seção Comentários)

Confira também

RtlMoveMemory