InterlockedExchangePointer 함수(wdm.h)

InterlockedExchangePointer 루틴은 포인터를 새 값으로 설정하는 원자성 연산을 수행합니다.

구문

PVOID InterlockedExchangePointer(
  [in, out]      PVOID volatile *Target,
  [in, optional] PVOID          Value
);

매개 변수

[in, out] Target

PVOID 값에 대한 포인터입니다. 루틴 집합(*대상)을 으로 설정합니다.

[in, optional] Value

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

반환 값

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

설명

InterlockedExchangePointer 는 여러 스레드에서 공유하는 포인터 변수 업데이트를 동기화하는 빠르고 원자성적인 방법을 제공합니다.

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

성능 향상을 위해 대상 매개 변수는 시스템 유형에 따라 32비트 또는 64비트 경계에 맞춰야 합니다.

InterlockedExchangePointer에 대한 호출은 다른 InterlockedXxx 호출에 대해서만 원자성입니다.

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

요구 사항

   
지원되는 최소 클라이언트 Windows 2000부터 사용할 수 있습니다.
대상 플랫폼 데스크톱
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h, Miniport.h 포함)
IRQL 모든 수준

참고 항목

InterlockedCompareExchange

InterlockedCompareExchangePointer

InterlockedExchange