Compartilhar via


Função InterlockedCompareExchangePointer (wdm.h)

A rotina InterlockedCompareExchangePointer executa uma operação atômica que compara o valor do ponteiro de entrada apontado por Destination com o valor de ponteiro Comperand.

Sintaxe

PVOID InterlockedCompareExchangePointer(
  [in, out] PVOID volatile *Destination,
  [in]      PVOID          Exchange,
  [in]      PVOID          Comperand
);

Parâmetros

[in, out] Destination

Um ponteiro para um valor PVOID. Se (*Destino) = Comperand, a rotina definirá (*Destino) como Exchange.

[in] Exchange

Especifica o valor PVOID para o qual definir (*Destino).

[in] Comperand

Especifica o valor PVOID a ser comparado com (*Destino).

Retornar valor

InterlockedCompareExchangePointer retorna o valor original do ponteiro em *Destination (ou seja, o valor desse ponteiro na entrada para a rotina).

Comentários

Se Comperand for igual a *Destination, *Destination será definido como igual ao Exchange. Caso contrário, *O destino não será alterado.

InterlockedCompareExchangePointer fornece uma maneira rápida e atômica de sincronizar o teste e a atualização de uma variável de ponteiro que é compartilhada por vários threads. Se o valor de entrada apontado por Destination for igual ao valor de Comperand, o valor apontado por Destination será definido como o valor do Exchange.

InterlockedCompareExchangePointer foi projetado para velocidade e, normalmente, é implementado embutido por um compilador. InterlockedCompareExchangePointer é atômico apenas em relação a outras chamadas Xxx interlocked. Ele não usa um bloqueio de rotação e pode ser usado com segurança em dados pagináveis.

A rotina InterlockedCompareExchangePointer é atômica apenas em relação a outras chamadasXxx interlocked.

As operações interligadas não podem ser usadas na memória não armazenada em cache.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Miniport.h)
IRQL Qualquer nível

Confira também

Interlockedcompareexchange

InterlockedExchange

InterlockedExchangePointer