RtlCopyMemoryNonTemporal-Funktion (wdm.h)

  • Artikel

Diese Funktion kopiert den Inhalt von einem Puffer in einen anderen mit nicht temporalen Verschiebungen, die den Cache nicht belasten. Beachten Sie, dass sich die Puffer nicht überlappen sollten.

Syntax

NTSYSAPI VOID RtlCopyMemoryNonTemporal(
  VOID       *Destination,
  const VOID *Source,
  SIZE_T     Length
);

Parameter

Destination

Ein Zeiger auf den Zielspeicherblock, in den die Bytes kopiert werden sollen.

Source

Ein Zeiger auf den Quellspeicherblock, aus dem die Bytes kopiert werden sollen.

Length

Die Anzahl der Bytes, die von der Quelle an das Ziel kopiert werden sollen.

Rückgabewert

Keine.

Hinweise

RtlCopyMemoryNonTemporal führt nur eine nicht temporale Kopie für x64-basierte Systeme aus, und das nur, wenn der Length-Parameter 8 Bytes oder mehr ist. Andernfalls entspricht diese Funktion RtlCopyMemory.

Aufrufer von RtlCopyMemoryNonTemporal können in jedem IRQL ausgeführt werden, wenn sich die Quell- und Zielspeicherblöcke im nicht auslagerten Systemspeicher befinden. Andernfalls muss der Aufrufer unter IRQL <= APC_LEVEL ausgeführt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 2003 und höher.
Zielplattform Universell
Header wdm.h
DLL NtDll.lib (Benutzermodus); NtosKrnl.lib (Kernelmodus)
IRQL Beliebige Ebene (siehe Abschnitt Hinweise)

Weitere Informationen

RtlCopyMemory