XboxLiveDeviceAddress.GetSnapshotAsBytes(Byte[], UInt32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
XboxLiveDeviceAddress をバイト配列に保存します。
このメソッドを使用すると、XboxLiveDeviceAddress.CreateFromSnapshotBytes メソッドで使用するスナップショットを保存できます。
重要
この API は、すべてのアプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
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)パラメーター
- buffer
-
Byte[]
byte[]
スナップショットを受け取るバイトの配列。
XboxLiveDeviceAddress.MaxSnapshotBytesSize プロパティを使用して、渡す配列の適切なサイズを決定します。
- bytesWritten
-
UInt32
unsigned int
uint32_t
正常に完了すると、スナップショット内のバイト数。 失敗した場合は -1。
注釈
スナップショットは、Xbox Live マッチメーキングなどの帯域外チャネルを介してリモート デバイスに送信できる、シリアル化された形式の XboxLiveDeviceAddress オブジェクトです。 ただし、特定の時刻にデバイスのネットワーク アドレス情報を表し、時間の経過と同時に変更される可能性があります。 不要な接続の問題を回避するには、ローカル デバイス アドレスで XboxLiveDeviceAddress.SnapshotChanged イベントをリッスンして、スナップショットコンテンツがいつ更新されたかを把握し、シリアル化されたスナップショットを送信またはキャッシュした場所に更新して、リモート デバイスに常に最新の情報が提供されるようにする必要があります。