Bewerken

Delen via


RtlWriteNonVolatileMemory function (ntddk.h)

The routine RtlWriteNonVolatileMemory copies the contents of a source buffer to a non-volatile destination memory buffer.

Syntax

NTSYSAPI NTSTATUS RtlWriteNonVolatileMemory(
  PVOID      NvToken,
  VOID       *NvDestination,
  const VOID *Source,
  SIZE_T     Size,
  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.

NvDestination

A pointer to the non-volatile destination buffer to copy to.

Source

A pointer to the source buffer to copy from.

Size

The length, in bytes, of the copy operation.

Flags

Reserved for future use.

Return value

The routine RtlWriteNonVolatileMemory 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 is a RtlCopyMemory equivalent for non-volatile memory the value add is only with verifier enabled. When the verifier is enabled, ranges that are modified can be tracked in NvToken and can be reported in RtlFreeNonVolatileToken if a flush is not called for a write. 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)

See also

RtlCopyMemory

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlGetNonVolatileToken