Edit

RtlPrefetchMemoryNonTemporal function (wdm.h)

  • Article

The RtlPrefetchMemoryNonTemporal routine provides a hint to the processor that a buffer should be temporarily moved into the processor cache.

Syntax

NTSYSAPI VOID RtlPrefetchMemoryNonTemporal(
  [in] PVOID  Source,
  [in] SIZE_T Length
);

Parameters

[in] Source

A pointer to the buffer to be moved into the processor cache.

[in] Length

The length of the buffer to be moved.

Return value

None.

Remarks

You should use this routine only for a buffer that will be written to or read from exactly once. Note that RtlPrefetchMemoryNonTemporal is only a hint to the processor: the buffer is not guaranteed to be moved into the cache. On x86-based and x64-based systems, this routine uses the prefetchnta instruction.

Requirements

Requirement Value
Minimum supported client Available in Windows Server 2003 and later versions of Windows.
Target Platform Universal
Header wdm.h (include Ntddk.h, Wdm.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Any level