RtlCopyMemory 宏 (ntddstor.h)

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

語法

void RtlCopyMemory(
   Destination,
   Source,
   Length
);

參數

Destination

數據類型：void*。 要複製位元組的目標記憶體區塊指標。

Source

數據類型：const void*。 要從中複製位元組的來源記憶體區塊指標。

Length

數據類型：size_t。 要從來源複製到目的地的位元組數目。

傳回值

無

備註

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

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

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

規格需求

另請參閱

RtlMoveMemory