RtlFlushNonVolatileMemoryRanges function (ntddk.h)

Article
02/22/2024

The routine RtlFlushNonVolatileMemoryRanges optimally flushes the given non-volatile memory regions.

Syntax

NTSYSAPI NTSTATUS RtlFlushNonVolatileMemoryRanges(
  PVOID            NvToken,
  PNV_MEMORY_RANGE NvRanges,
  SIZE_T           NumRanges,
  ULONG            Flags
);

Parameters

NvToken

A pointer to an opaque structure that has information about various properties of the non-volatile memory region which RtlGetNonVolatileToken had returned.

NvRanges

Specifies an array of NV_MEMORY_RANGE structures which describe the non-volatile memory regions to flush

NumRanges

Specifies the number of elements in the NVRanges array.

Flags

For flags specified, refer RtlFlushNonVolatileMemory as this routine also honors the flags apart from passing it to RtlFlushNonVolatileMemory.

Return value

The routine RtlFlushNonVolatileMemoryRanges returns one of the following:

Return code	Description
STATUS_INVALID_PARAMETER	NvToken is an invalid pointer or token.
STATUS_SUCCESS	The request was successful.

Remarks

This routine is currently not supported for Windows Server until the next major release of Windows Server.

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1703
Minimum supported server	None supported
Target Platform	Windows
Header	ntddk.h (include Winnt.h)