WriteUInt64ToUserRelease-Funktion (usermode_accessors.h)

The WriteUInt64ToUserRelease function safely writes a UINT64 value to user-mode memory with release semantics.

Syntax

VOID WriteUInt64ToUserRelease(
  volatile UINT64 *Destination,
  UINT64          Value
);

Parameters

Destination

[out] Ein Zeiger auf den Speicherort des Benutzermodus, an dem der UINT64-Wert geschrieben wird.

Value

[in] Der UINT64-Wert, der in den Zielspeicherort geschrieben werden soll.

Return value

None

Remarks

Diese Funktion bietet eine sichere Möglichkeit, einen UINT64-Wert in den Arbeitsspeicher des Benutzermodus zu schreiben. Sie stellt sicher, dass es sich bei der angegebenen Adresse um eine Benutzermodusadresse handelt, bevor Sie sie schreiben. The release semantics ensure that preceding memory operations can't be reordered after this write operation.

Diese Funktion erzwingt keine Ausrichtung.

Es löst eine strukturierte Ausnahme aus, wenn der Speicherzugriff fehlschlägt, z. B. wenn die Zieladresse keine Benutzermodusadresse ist oder nicht darauf zugegriffen werden kann.

Diese Funktion wird niemals vom Compiler optimiert, oder der Compiler erstellt zusätzlichen Zugriff auf diesen Speicherspeicherort, bevor die Funktion aufgerufen wird oder nachdem die Funktion zurückgegeben wird (es sei denn, der Quellcode führt diese Zugriffe explizit aus). The memory access is performed with memory_order_release semantics, providing additional ordering guarantees for synchronization operations.

Diese Funktion funktioniert auf allen Versionen von Windows, nicht nur auf dem neuesten. You need to consume the latest WDK to get the function declaration from the usermode_accessors.h header. You also need the library (umaccess.lib) from the latest WDK. Der resultierende Treiber wird jedoch in älteren Versionen von Windows einwandfrei ausgeführt.

Requirements

See also

WriteUInt64ToUser

ReadUInt64FromUserAcquire