RtlGetNonVolatileToken, fonction (ntddk.h)

La routine, RtlGetNonVolatileToken, obtient différentes propriétés sur une mémoire tampon de mémoire non volatile et les stocke dans la variable NvToken.

Syntaxe

NTSYSAPI NTSTATUS RtlGetNonVolatileToken(
  PVOID  NvBuffer,
  SIZE_T Size,
  PVOID  *NvToken
);

Paramètres

NvBuffer

Pointeur vers la mémoire non volatile pour laquelle le NvToken retourné va suivre l’état. Il doit s’agir d’une adresse obtenue à partir d’un objet de mappage de fichiers.

Size

La longueur, en octets, du tampon de mémoire non volatile NvBuffer pointe vers.

NvToken

Pointeur vers une structure opaque qui suit les informations relatives à la région de mémoire non volatile donnée que RtlGetNonVolatileToken avait retournée.

Valeur de retour

La routine RtlGetNonVolatileToken retourne l’un des codes d’état :

Code de retour Description
STATUS_ACCESS_DENIED
L’appelant avait des droits d’accès insuffisants pour effectuer l’action demandée.
STATUS_INFO_LENGTH_MISMATCH
L’adresse de base spécifiée est en dehors de la plage d’adresses accessibles.
STATUS_INVALID_PARAMETER
NvBuffer n’est pas la même longueur que celle spécifiée dansSize.
STATUS_SUCCESS
La demande a abouti.

Remarques

Cette routine n’est actuellement pas prise en charge pour Windows Server jusqu’à la prochaine version majeure de Windows Server.

Configuration requise

   
Client minimal pris en charge Windows 10 version 1703
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête ntddk.h (include Winnt.h)

Voir aussi

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlWriteNonVolatileMemory