Функция InterlockedCompareExchange (miniport.h)

Статья
03/14/2023

Подпрограмма InterlockedCompareExchange выполняет атомарную операцию, которая сравнивает входное значение, указанное назначением , со значением Comparand.

Синтаксис

LONG InterlockedCompareExchange(
  [in, out] LONG volatile *Destination,
            LONG          ExChange,
            LONG          Comperand
);

Параметры

[in, out] Destination

Указатель на входное значение, сравниваемое со значением Comparand.

ExChange

Указывает выходное значение, на которое указывает Destination , если входное значение , на которое указывает Destination, равно значению Comparand.

Comperand

Задает значение, сравниваемое с входным значением, на которое указывает destination.

Возвращаемое значение

InterlockedCompareExchange возвращает исходное значение *Destination.

InterlockedCompareExchange предоставляет быстрый и атомарный способ синхронизации тестирования и обновления переменной, совместно используемой несколькими потоками. Если входное значение, указанное назначением , равно значению Comparand, выходному значению Destination присваивается значение Exchange.

InterlockedCompareExchange предназначен для скорости и, как правило, реализуется встроенным компилятором. InterlockedCompareExchange является атомарным только по отношению к другим вызовам InterlockedXxx . Он не использует спин-блокировку и может безопасно использоваться для страничных данных.

Операции с блокировкой нельзя использовать в некэшированной памяти.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 2000.
Целевая платформа	Универсальное
Верхняя часть	miniport.h (включая Wdm.h, Ntddk.h, Ntifs.h, Miniport.h)
Библиотека	OneCoreUAP.lib в Windows 10
IRQL	Любой уровень