RtlFlushNonVolatileMemory-Funktion (ntddk.h)

Die Routine RtlFlushNonVolatileMemory leert den angegebenen nicht flüchtigen Speicherbereich optimal.

Syntax

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

Parameter

NvToken

Ein Zeiger auf eine nicht transparente Struktur mit Informationen zu verschiedenen Eigenschaften des nicht flüchtigen Speicherbereichs, den RtlGetNonVolatileToken zurückgegeben hatte.

NvBuffer

Ein Zeiger auf den nicht flüchtigen Speicher, der geleert werden soll. Dies sollten Benutzeradressen sein, die aus einem Dateizuordnungsobjekt ermittelt wurden.

Size

Die Länge des nicht flüchtigen Speicherpuffers, auf den NvBuffer zeigt, in Bytes.

Flags

Eines der folgenden Flags kann angegeben werden:

Flags Bedeutung
FLUSH_NV_MEMORY_IN_FLAG_NO_DRAIN Gibt an, dass diese Routine nicht warten muss, bis die Leerung geleert wird.

Rückgabewert

Die Routine RtlFreeNonVolatileToken gibt einen der Statuscodes zurück:

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER
NvToken ist ein ungültiger Zeiger oder ein ungültiges Token.
STATUS_SUCCESS
Die Anforderung wurde erfolgreich gesendet.

Hinweise

Diese Routine RtlFlushNonVolatileMemory kann nvToken auch mehr Kontext hinzufügen, um Überprüfungen zu unterstützen. Diese Routine wird für Windows Server bis zur nächsten Hauptversion von Windows Server derzeit nicht unterstützt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10, Version 1703
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile ntddk.h (winnt.h enthalten)

Weitere Informationen:

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlGetNonVolatileToken

RtlWriteNonVolatileMemory