RtlCopyMemory 宏 (wdm.h)

  • 發行項

RtlCopyMemory 例程會將來源記憶體區塊的內容複製到目的地記憶體區塊。

語法

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

參數

[out] Destination

要複製位元組的目標記憶體區塊指標。

[in] Source

要從中複製位元組的來源記憶體區塊指標。

[in] Length

要從來源複製到目的地的位元組數目。

傳回值

無

備註

RtlCopyMemory 的執行速度比 RtlMoveMemory 快。 不過， RtlCopyMemory 要求 Source 和 Length 所定義的來源記憶體區塊不能重疊 目的地 記憶體區塊，而目的地記憶體區塊是由 Destination 和 Length 所定義。 相反地， RtlMoveMemory 會正確處理來源和目的地記憶體區塊重疊的情況。

新的驅動程序應該使用 RtlCopyMemory 例程，而不是 RtlCopyBytes。

如果來源和目的地記憶體區塊位於非分頁的系統記憶體中， RtlCopyMemory 的呼叫端可以在任何 IRQL 上執行。 否則，呼叫端必須在 IRQL <= APC_LEVEL執行。

規格需求

需求 值
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtDll.dll (使用者模式) ;NtosKrnl.exe (核心模式)
IRQL 任何層級 (請參閱一節)

另請參閱

RtlMoveMemory