InterlockedExchange16-Funktion (winnt.h)

Artikel
11/08/2024

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

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

SHORT InterlockedExchange16(
  [in, out] SHORT volatile *Destination,
  [in]      SHORT          ExChange
);

Parameter

[in, out] Destination

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

[in] ExChange

Der Wert, der mit dem wert ausgetauscht werden soll, auf den Destinationverweist.

Rückgabewert

Die Funktion gibt den Anfangswert des parameters Destination 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 _InterlockedExchange16.

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

Itanium-basierte Systeme: Verwenden Sie stattdessen InterlockedExchangeAcquire64-.

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	winnt.h (enthalten Windows.h)