XboxLiveDeviceAddress.GetSnapshotAsBytes(Byte[], UInt32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Enregistre une XboxLiveDeviceAddress dans un tableau d’octets.
Vous pouvez utiliser cette méthode pour enregistrer un instantané à utiliser avec la méthode XboxLiveDeviceAddress.CreateFromSnapshotBytes.
Important
Cette API n’est pas disponible pour toutes les applications. À moins que votre compte de développeur ne soit spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
public:
virtual void GetSnapshotAsBytes(Platform::Array <byte> ^ buffer, [Out] unsigned int & bytesWritten) = GetSnapshotAsBytes;void GetSnapshotAsBytes(winrt::array_view <byte> & buffer, [Out] uint32_t & bytesWritten);public void GetSnapshotAsBytes(byte[] buffer, out uint bytesWritten);Public Sub GetSnapshotAsBytes (buffer As Byte(), ByRef bytesWritten As UInteger)Paramètres
- buffer
-
Byte[]
byte[]
Tableau d’octets à recevoir le instantané.
Utilisez la propriété XboxLiveDeviceAddress.MaxSnapshotBytesSize pour déterminer la taille appropriée du tableau que vous transmettez.
- bytesWritten
-
UInt32
unsigned int
uint32_t
Une fois l’exécution réussie, le nombre d’octets dans le instantané. En cas d’échec, -1.
Remarques
Les instantanés sont des formes sérialisées d’objets XboxLiveDeviceAddress qui peuvent être transmis à des appareils distants via des canaux hors bande tels que le matchmaking Xbox Live. Toutefois, ils représentent les informations d’adresse réseau d’un appareil à un moment donné, et ils peuvent changer au fil du temps. Pour éviter les problèmes de connectivité inutiles, vous devez écouter les événements XboxLiveDeviceAddress.SnapshotChanged sur l’adresse de l’appareil local pour savoir quand son contenu instantané a été mis à jour, et actualiser les instantané sérialisées partout où vous l’avez transmis ou mis en cache, afin que les appareils distants disposent toujours des informations les plus récentes.