Skip to main content

XUserUnregisterForChangeEvent

이전에 등록된 사용자 변경 콜백의 등록을 취소합니다.

구문

매개변수

token   _In_
형식: XTaskQueueRegistrationToken
XUserRegisterForChangeEvent가 반환하는 토큰으로, 등록 취소할 콜백을 식별합니다. wait   _In_
형식: bool
보류 중인 콜백이 완료될 때까지 차단할지 여부를 나타냅니다.

반환값

형식: bool wait가 false이고 등록 취소가 보류 중인 경우 false를 반환합니다. 그렇지 않으면 true를 반환합니다.

설명

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 Time-sensitive threads를 참조하십시오.
알림의 등록 취소: 등록 취소는 등록된 콜백 집합에서 토큰에 해당하는 콜백을 제거합니다.
  • 콜백 토큰에 대한 콜백이 실행 중이 아니면, 호출이 true를 반환합니다.
  • 콜백이 실행 중이고 wait가 true이면, 실행 중인 콜백이 완료될 때까지 호출이 차단됩니다.
  • 콜백이 실행 중이고 wait가 false이면, 호출은 차단되지 않고 false를 반환합니다. 토큰에 대한 콜백이 완료되면 토큰은 자동으로 등록 취소됩니다.
이 메커니즘을 사용하면 다음과 같은 코딩 패턴이 가능합니다.
  1. 등록 취소 호출 이후 콜백이 절대 호출되지 않도록 등록 취소에서 차단할 수 있습니다.
  2. 차단하지 않도록 선택할 수 있습니다. 데이터를 삭제하기 전에 콜백이 완료되도록 해야 하는 경우, wait를 false로 설정하고 주기적으로 unregister를 호출할 수 있습니다. 마침내 true를 반환하면 모든 콜백이 완료된 것이므로 상태를 삭제할 수 있습니다.
  3. unregister 호출이 콜백을 호출하지 않는 경우, wait에 false를 전달하고 반환값을 무시할 수 있습니다.
사용자 변경 콜백을 등록하려면 XUserRegisterForChangeEvent를 호출합니다. XUserChangeEvent 열거형은 변경 이벤트 유형을 지정합니다. XUserChangeEventCallback은 사용자 변경 이벤트에 대한 콜백입니다. 다음 예제에서는 사용자 변경 이벤트를 처리하는 방법을 보여줍니다.

요구 사항

헤더: XUser.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, Steam Deck, XBOX One 계열 콘솔 및 XBOX Series 콘솔

개념 문서

함께 보기

XUser XUserRegisterForChangeEvent XUserChangeEvent XUserChangeEventCallback
마지막 수정일 2026년 8월 24일