RtlFillMemoryUlonglong macro (ntifs.h)

Article
02/22/2024

The RtlFillMemoryUlonglong routine fills a given range of memory with one or more repetitions of a given ULONGLONG value.

Syntax

void RtlFillMemoryUlonglong(
  [out]  Destination,
  [in]   Length,
  [in]   Pattern
);

Parameters

[out] Destination

Pointer to the start of the range of memory to be filled. This address must be ULONGLONG-aligned.

[in] Length

Number of bytes to fill. This value must be a multiple of sizeof(ULONGLONG). (Note: SIZE_T is defined in basetsd.h.)

[in] Pattern

ULONGLONG value with which to fill the range starting at Destination and extending for Length bytes.

Return value

None

Remarks

If the range of memory starting at Destination is nonpaged, the caller can be running at any IRQL. Otherwise, callers of RtlFillMemoryUlonglong must be running at IRQL < DISPATCH_LEVEL.

For more information about managing buffered data and initializing driver-allocated buffers, see Buffered Data and Buffer Initialization.

For AMD64 systems, this routine is a macro. For non-AMD64 systems, this routine is contained in Ntoskrnl.lib.

Requirements

Requirement	Value
Minimum supported client	For AMD64 systems, Windows 2000. For non-AMD64 systems, Windows 7.
Target Platform	Universal
Header	ntifs.h (include Ntifs.h, FltKernel.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	See Remarks section.