RtlFlushNonVolatileMemory, fonction (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 différentes propriétés de la région de mémoire non volatile que RtlGetNonVolatileToken avait retournée.

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

La longueur, en octets, du tampon de mémoire non volatile 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 vide soit vidé.

Valeur de retour

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

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 davantage de contexte à NvToken pour aider les vérificateurs. 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

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlGetNonVolatileToken

RtlWriteNonVolatileMemory