Skip to main content

XUserDeviceAssociationChange

디바이스 연결이 변경될 때 이전 디바이스 연결과 새 디바이스 연결을 지정합니다.

구문

멤버

deviceId
형식: APP_LOCAL_DEVICE_ID
사용자 연결이 변경되는 디바이스의 ID입니다. oldUser
형식: XUserLocalId
디바이스와 연결된 이전 사용자 ID입니다. newUser
형식: XUserLocalId
디바이스와 연결된 새 사용자 ID입니다.

설명

XUserDeviceAssociationChange에 대한 모든 인수는 “null”일 수 있습니다.
  • deviceId가 XUserNullDeviceId와 같은 경우 사용자 변경은 로그인된 사용자와 연결된 모든 디바이스에 적용됩니다.
  • oldUser가 XUserNullUserLocalId와 같은 경우 디바이스와 사용자 간의 연결이 새로 생성된 것입니다.
  • newUser가 XUserNullUserLocalId와 같은 경우 기존 디바이스와 사용자 간의 연결이 손실된 것입니다.
newUserXUserAddAsync 호출을 통해 이미 타이틀에 추가된 사용자만 참조할 수 있습니다. 시스템 선택기를 사용하여 타이틀이 알지 못하는 사용자에게 입력 디바이스를 페어링한 경우, newUser는 XUserNullUserLocalId와 같게 됩니다. 자세한 내용은 Users and input devices를 참조하십시오.
이러한 멤버는 memcmp 또는 동등한 방법을 사용하여 비교할 수 있는 원시 바이트 구조로 처리해야 합니다. 예를 들면 다음과 같습니다.
XUserDeviceAssociationChangedCallback 콜백 함수는 XUserDeviceAssociationChange 구조체에 대한 포인터를 사용합니다. 콜백 함수는 콜백이 등록될 때 XUserRegisterForDeviceAssociationChanged 함수에 컨텍스트를 전달합니다. XUserRegisterForDeviceAssociationChanged 함수는 사용자 디바이스 연결 변경 이벤트에 대한 콜백을 등록합니다.

요구 사항

헤더: XUser.h 지원되는 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

함께 보기

XUser XUserDeviceAssociationChangedCallback XUserRegisterForDeviceAssociationChanged
마지막 수정일 2026년 8월 24일