Skip to main content

XUserDeviceAssociationChange

デバイスとの関連付けが変更されたときの、以前のデバイス関連付けおよび新しいデバイス関連付けを指定します。

構文

メンバー

deviceId
Type: APP_LOCAL_DEVICE_ID
ユーザーの関連付けが変更されたデバイスの ID です。 oldUser
Type: XUserLocalId
デバイスに関連付けられていた以前のユーザー ID です。 newUser
Type: XUserLocalId
デバイスに新しく関連付けられたユーザー ID です。

解説

XUserDeviceAssociationChange のすべての引数は「null」になる可能性があります。
  • deviceId が XUserNullDeviceId に等しい場合、ユーザーの変更はすべてのデバイスに適用されます。この場合、すべてのデバイスがサインイン済みのユーザーと関連付けられています。
  • oldUser が XUserNullUserLocalId に等しい場合、そのデバイスとユーザーの関連付けは新規のものです。
  • newUser が XUserNullUserLocalId に等しい場合、既存のデバイスとユーザーの関連付けは失われています。
newUser は、XUserAddAsync の呼び出しによって既にタイトルに追加済みのユーザーのみを参照できます。システム ピッカーが、タイトルが認識していないユーザーに入力デバイスをペアリングするために使用された場合、newUser は XUserNullUserLocalId に等しくなります。詳しくは、「ユーザーと入力デバイス」をご覧ください。
これらのメンバーは、memcmp または同等の方法で比較できる生のバイト構造として扱う必要があります。次に例を示します。
XUserDeviceAssociationChangedCallback コールバック関数は、XUserDeviceAssociationChange 構造体へのポインターを使用します。 このコールバック関数は、コールバックの登録時に XUserRegisterForDeviceAssociationChanged 関数へコンテキストを渡します。 XUserRegisterForDeviceAssociationChanged 関数は、ユーザーとデバイスの関連付け変更イベント用のコールバックを登録します。

要件

ヘッダー: XUser.h サポートされているプラットフォーム: Windows、XBOX One ファミリ本体および XBOX Series 本体

関連項目

XUser XUserDeviceAssociationChangedCallback XUserRegisterForDeviceAssociationChanged
最終更新日 2026年8月24日