Makro RtlCopyMemory (wdm.h)

Artikel
02/27/2024

RtlCopyMemory rutin menyalin konten blok memori sumber ke blok memori tujuan.

Sintaks

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

Parameter

[out] Destination

Penunjuk ke blok memori tujuan untuk menyalin byte.

[in] Source

Pointer ke blok memori sumber untuk menyalin byte dari.

[in] Length

Jumlah byte yang akan disalin dari sumber ke tujuan.

Nilai kembali

Tidak ada

Keterangan

RtlCopyMemory berjalan lebih cepat daripada RtlMoveMemory. Namun, RtlCopyMemory mengharuskan blok memori sumber, yang ditentukan oleh Sumber dan Panjang, tidak dapat tumpang tindih dengan blok memori tujuan, yang ditentukan oleh Tujuan dan Panjang. Sebaliknya, RtlMoveMemory menangani kasus dengan benar di mana blok memori sumber dan tujuan tumpang tindih.

Driver baru harus menggunakan rutinitas RtlCopyMemory alih-alih RtlCopyBytes.

Penelepon RtlCopyMemory dapat berjalan di IRQL apa pun jika blok memori sumber dan tujuan berada dalam memori sistem yang tidak di-patahkan. Jika tidak, pemanggil harus berjalan di IRQL <= APC_LEVEL.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtDll.dll (mode pengguna); NtosKrnl.exe (mode kernel)
IRQL	Tingkat apa pun (Lihat bagian Keterangan)

Lihat juga

RtlMoveMemory

Bagikan melalui