Freigeben über


RtlWriteNonVolatileMemory-Funktion (ntddk.h)

Die Routine RtlWriteNonVolatileMemory kopiert den Inhalt eines Quellpuffers in einen nicht veränderlichen 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 veränderliche Speicherbereichs enthält, die RtlGetNonVolatileToken zurückgegeben haben.

NvDestination

Ein Zeiger auf den nicht veränderliche Zielpuffer, in den kopiert werden soll.

Source

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

Size

Die Länge des Kopiervorgangs in Bytes.

Flags

Reserviert für die zukünftige Verwendung.

Rückgabewert

Die Routine RtlWriteNonVolatileMemory gibt eine der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER
NvToken- ist ein ungültiger Zeiger oder Token.
STATUS_SUCCESS
Die Anforderung war erfolgreich.

Bemerkungen

Dies ist eine RtlCopyMemory- Entsprechung für nicht veränderliche Speicher, die das Hinzufügen des Werts nur mit aktiviertem Prüfer ist. Wenn die Überprüfung aktiviert ist, können geänderte Bereiche in NvToken- nachverfolgt werden und in RtlFreeNonVolatileToken gemeldet werden, wenn kein Leerlauf für einen Schreibvorgang aufgerufen wird. Diese Routine wird derzeit für Windows Server bis zur nächsten Hauptversion von Windows Server nicht unterstützt.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 10, Version 1703
mindestens unterstützte Server- Keine unterstützt
Zielplattform- Fenster
Header- ntddk.h (include Winnt.h)

Siehe auch

RtlCopyMemory

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlGetNonVolatileToken