Fonction RtlFlushNonVolatileMemory (ntddk.h)

La routine RtlFlushNonVolatileMemory vide de manière optimale la région de mémoire non volatile donnée.

Syntaxe

NTSYSAPI NTSTATUS RtlFlushNonVolatileMemory(
  PVOID  NvToken,
  PVOID  NvBuffer,
  SIZE_T Size,
  ULONG  Flags
);

Paramètres

NvToken

Pointeur vers une structure opaque qui contient des informations sur les différentes propriétés de la région de mémoire non volatile que RtlGetNonVolatileToken avait retournées.

NvBuffer

Pointeur vers la mémoire non volatile à vider. Il doit s’agir d’adresses utilisateur obtenues à partir d’un objet de mappage de fichiers.

Size

Longueur, en octets, de la mémoire tampon non volatile que NvBuffer pointe vers.

Flags

L’un des indicateurs suivants peut être spécifié :

Indicateurs Signification
FLUSH_NV_MEMORY_IN_FLAG_NO_DRAIN Spécifie que cette routine n’a pas besoin d’attendre que le vidage se vide.

Valeur retournée

La routine RtlFreeNonVolatileToken retourne l’un des codes status :

Code de retour Description
STATUS_INVALID_PARAMETER
NvToken est un pointeur ou un jeton non valide.
STATUS_SUCCESS
La demande a abouti.

Remarques

Cette routine RtlFlushNonVolatileMemory peut également ajouter plus de contexte à NvToken pour aider les vérificateurs. Cette routine n’est actuellement pas prise en charge pour Windows Server avant la prochaine version majeure de Windows Server.

Configuration requise

Condition requise Valeur
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 (inclure Winnt.h)

Voir aussi

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlGetNonVolatileToken

RtlWriteNonVolatileMemory