InterlockedExchange8-Funktion (winnt.h)

Artikel
11/08/2024

Legt eine 8-Bit-Variable auf den angegebenen Wert als Atomvorgang fest.

Verwenden Sie zum Arbeiten mit einer Zeigervariablen die InterlockedExchangePointer--Funktion.

Verwenden Sie die InterlockedExchange16--Funktion, um eine 16-Bit-Variable zu verwenden.

Verwenden Sie die InterlockedExchange-Funktion, um eine 32-Bit-Variable zu verwenden.

Verwenden Sie die InterlockedExchange64--Funktion, um eine 64-Bit-Variable zu verwenden.

Syntax

CHAR InterlockedExchange8(
  [in, out] CHAR volatile *Target,
  [in]      CHAR          Value
);

Parameter

[in, out] Target

Ein Zeiger auf den wert, der ausgetauscht werden soll. Die Funktion legt diese Variable auf Valuefest und gibt den vorherigen Wert zurück.

[in] Value

Der wert, der mit dem wert ausgetauscht werden soll, auf den durch Targetverwiesen wird.

Rückgabewert

Die Funktion gibt den Anfangswert des parameters Target zurück.

Bemerkungen

Die verriegelten Funktionen bieten einen einfachen Mechanismus zum Synchronisieren des Zugriffs auf eine Variable, die von mehreren Threads gemeinsam genutzt wird. Diese Funktion ist atomar in Bezug auf Aufrufe anderer verzahnter Funktionen.

Diese Funktion wird mithilfe eines systeminternen Compilers implementiert. Weitere Informationen finden Sie in der WinBase.h-Headerdatei und _InterlockedExchange8.

Diese Funktion generiert eine vollständige Speicherbarriere (oder einen Zaun), um sicherzustellen, dass Speichervorgänge in der Reihenfolge abgeschlossen werden.

Hinweis Diese Funktion wird auf Windows RT-basierten Systemen unterstützt.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8 [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2012 [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winnt.h (enthalten Windows.h)