XUserDeviceAssociationChange
장치 연결 변경 시 이전 및 신규 장치 연결을 지정합니다.
구문
typedef struct XUserDeviceAssociationChange {
APP_LOCAL_DEVICE_ID deviceId;
XUserLocalId oldUser;
XUserLocalId newUser;
} XUserDeviceAssociationChange
멤버
deviceId
형식: APP_LOCAL_DEVICE_ID
사용자 연결이 변경된 장치의 ID입니다.
oldUser
형식: XUserLocalId
장치와 연결된 이전 사용자 ID입니다.
newUser
형식: XUserLocalId
장치와 연결된 신규 사용자 ID입니다.
비고
XUserDeviceAssociationChange에 관한 모든 인수는 "null"일 수 있습니다.
- deviceId가 XUserNullDeviceId와 같다면 사용자 변경은 모든 디바이스에 적용됩니다(모든 디바이스가 로그인한 사용자와 연결된 경우).
- oldUser가 XUserNullUserLocalId와 같다면 디바이스-사용자 연결은 새로운 것입니다.
- newUser가 XUserNullUserLocalId와 같다면 기존 디바이스-사용자 연결은 손실됩니다.
참고 항목
newUser는 XUserAddAsync에 대한 호출을 통해 이미 타이틀에 추가된 사용자만 참조할 수 있습니다. 시스템 선택기를 사용하여 타이틀이 모르는 사용자에게 입력 장치를 페어링한 경우, newUser는 XUserNullUserLocalId와 동일하게 됩니다. 자세한 내용은 사용자 및 입력 장치를 참조하세요.
이러한 멤버는 memcmp 또는 동등한 메서드를 사용하여 비교할 수 있는 원시 바이트 구조로 처리해야 합니다. 예:
XUserDeviceAssociationChange *change; // incoming argument from callback
if(memcmp(&change->deviceId, &XUserNullDeviceId, sizeof(APP_LOCAL_DEVICE_ID) == 0))
{
}
if(memcmp(&change->newUser, &XUserNullUserLocalId, sizeof(XUserLocalId) == 0))
{
}
XUserDeviceAssociationChangedCallback 콜백 함수는 XUserDeviceAssociationChange 구조에 관한 포인터를 사용합니다.
콜백 함수는 콜백이 등록되면 컨텍스트를 XUserRegisterForDeviceAssociationChanged 함수로 전달합니다.
XUserRegisterForDeviceAssociationChanged 함수는 사용자 장치 연결 변경 이벤트에 대한 콜백을 등록합니다.
요건
헤더: XUser.h
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔