RtlCopyMemory 매크로(wdm.h)

RtlCopyMemory 루틴은 원본 메모리 블록의 내용을 대상 메모리 블록에 복사합니다.

구문

void RtlCopyMemory(
   void*       Destination,
   const void* Source,
   size_t      Length
);

매개 변수

[out] Destination

바이트를 복사할 대상 메모리 블록에 대한 포인터입니다.

[in] Source

바이트를 복사할 원본 메모리 블록에 대한 포인터입니다.

[in] Length

원본에서 대상으로 복사할 바이트 수입니다.

반환 값

없음

설명

RtlCopyMemory는RtlMoveMemory보다 빠르게 실행됩니다. 그러나 RtlCopyMemory를 사용하려면 원본 및 길이로 정의된 원본 메모리 블록이 대상및길이로 정의된 대상 메모리 블록과 겹칠 수 없습니다. 반면 RtlMoveMemory 는 원본 및 대상 메모리 블록이 겹치는 경우를 올바르게 처리합니다.

새 드라이버는 RtlCopyBytes 대신 RtlCopyMemory 루틴을 사용해야 합니다.

원본 및 대상 메모리 블록이 비페이지 시스템 메모리에 있는 경우 RtlCopyMemory 의 호출자는 모든 IRQL에서 실행될 수 있습니다. 그렇지 않으면 호출자가 IRQL <= APC_LEVEL 실행 중이어야 합니다.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtDll.dll(사용자 모드); NtosKrnl.exe(커널 모드)
IRQL	모든 수준(설명 섹션 참조)

추가 정보

RtlMoveMemory