다음을 통해 공유


InterlockedCompareExchangePointer 함수(miniport.h)

InterlockedCompareExchangePointer 루틴은 대상 가리키는 입력 포인터 값과 Comparand 포인터 값을 비교하는 원자성 작업을 수행합니다.

통사론

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

매개 변수

[in, out] Destination

PVOID 값에 대한 포인터입니다. (*Destination) = Comparand경우 루틴 집합(*대상)을 exchange .

[in] Exchange

설정할 PVOID 값(*대상)을 지정합니다.

Comperand

비교할 PVOID 값을 지정합니다(**Destination*).

반환 값

InterlockedCompareExchangePointer *대상 포인터의 원래 값(즉, 루틴 항목에서 이 포인터의 값)을 반환합니다.

발언

Comparand *대상같으면 *대상 exchange 동일하게 설정됩니다. 그렇지 않으면 *대상 변경되지 않습니다.

InterlockedCompareExchangePointer 여러 스레드에서 공유하는 포인터 변수의 테스트 및 업데이트를 동기화하는 빠르고 원자성 있는 방법을 제공합니다. Destination 가리키는 입력 값이 Comparand값과 같으면 대상 가리키는 값이Exchange값으로 설정됩니다.

InterlockedCompareExchangePointer 속도를 위해 설계되었으며 일반적으로 컴파일러에서 인라인으로 구현됩니다. InterlockedCompareExchangePointer 다른 InterlockedXxx 호출에 대해서만 원자성입니다. 스핀 잠금을 사용하지 않으며 페이지 가능한 데이터에서 안전하게 사용할 수 있습니다.

InterlockedCompareExchangePointer 루틴은 다른 InterlockedXxx 호출에 대해서만 원자성입니다.

캐시되지 않은 메모리에서는 연동 작업을 사용할 수 없습니다.

요구 사항

요구
지원되는 최소 클라이언트 Windows 2000부터 사용할 수 있습니다.
대상 플랫폼 바탕 화면
헤더 miniport.h(Wdm.h, Ntddk.h, Ntifs.h, Miniport.h 포함)
IRQL 모든 수준

참고 항목

InterlockedCompareExchange

InterlockedExchange

InterlockedExchangePointer