RtlWriteNonVolatileMemory-Funktion (ntddk.h)

Die Routine RtlWriteNonVolatileMemory kopiert den Inhalt eines Quellpuffers in einen nicht flüchtigen Zielspeicherpuffer.

Syntax

NTSYSAPI NTSTATUS RtlWriteNonVolatileMemory(
  PVOID      NvToken,
  VOID       *NvDestination,
  const VOID *Source,
  SIZE_T     Size,
  ULONG      Flags
);

Parameter

NvToken

Ein Zeiger auf eine undurchsichtige Struktur, die Informationen zu verschiedenen Eigenschaften des nicht flüchtigen Speicherbereichs enthält, den RtlGetNonVolatileToken zurückgegeben hat.

NvDestination

Ein Zeiger auf den nicht flüchtigen Zielpuffer, in den kopiert werden soll.

Source

Ein Zeiger auf den Quellpuffer, aus dem kopiert werden soll.

Size

Die Länge des Kopiervorgangs in Byte.

Flags

Für die zukünftige Verwendung reserviert.

Rückgabewert

Die Routine RtlWriteNonVolatileMemory gibt eine der folgenden Rückgaben 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

Dies ist eine RtlCopyMemory-Entsprechung für nicht flüchtigen Speicher, wobei der Wert nur bei aktiviertem Verifier hinzugefügt wird. Wenn die Überprüfung aktiviert ist, können geänderte Bereiche in NvToken nachverfolgt und in RtlFreeNonVolatileToken gemeldet werden, wenn keine Leerung für einen Schreibvorgang aufgerufen wird. Diese Routine wird für Windows Server bis zur nächsten Hauptversion von Windows Server derzeit nicht unterstützt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1703
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile ntddk.h (winnt.h einschließen)

Weitere Informationen

RtlCopyMemory

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlGetNonVolatileToken