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 | 모든 수준(설명 섹션 참조) |