RtlGetNonVolatileToken - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// ntddk.h

NTSYSAPI NTSTATUS RtlGetNonVolatileToken(
  PVOID  NvBuffer,
  SIZE_T Size,
  PVOID  *NvToken
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-ntddk-rtlgetnonvolatiletoken)

RtlGetNonVolatileToken function

Description

The routine, RtlGetNonVolatileToken, gets various properties about a non-volatile memory buffer and stores them in the variable NvToken.

Parameters

NvBuffer

A pointer to the non-volatile memory that the returned NvToken is going to track state for. This should be an address obtained from a file mapping object.

Size

The length, in bytes, of the non-volatile memory buffer NvBuffer points to.

NvToken

A pointer to an opaque structure that tracks information about the given non-volatile memory region which RtlGetNonVolatileToken had returned.

Return value

The routine RtlGetNonVolatileToken returns one of the status codes:

Return code Description
STATUS_ACCESS_DENIED The caller had insufficient access rights to perform the requested action.
STATUS_INFO_LENGTH_MISMATCH The specified base address is outside the range of accessible addresses.
STATUS_INVALID_PARAMETER The NvBuffer is not the same length as specified inSize.
STATUS_SUCCESS The request was successful.

Remarks

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

See also

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlWriteNonVolatileMemory