次の方法で共有


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 または同等のメソッドを使用して比較できる RAW バイト構造として処理する必要があります。 次に例を示します。

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 本体

関連項目

XUser

XUserDeviceAssociationChangedCallback

XUserRegisterForDeviceAssociationChanged