XboxLiveDeviceAddress.GetSnapshotAsBytes(Byte[], UInt32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сохраняет xboxLiveDeviceAddress в массив байтов.
Этот метод можно использовать для сохранения snapshot для использования с методом XboxLiveDeviceAddress.CreateFromSnapshotBytes.
Важно!
Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих 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[]
Массив байтов для получения snapshot.
Используйте свойство XboxLiveDeviceAddress.MaxSnapshotBytesSize , чтобы определить правильный размер передаваемого массива.
- bytesWritten
-
UInt32
unsigned int
uint32_t
При успешном завершении количество байтов в snapshot. При сбое — -1.
Комментарии
Моментальные снимки — это сериализованные формы объектов XboxLiveDeviceAddress , которые можно передавать на удаленные устройства по внештатным каналам, таким как xbox Live matchmaking. Однако они представляют сведения о сетевом адресе устройства в определенное время и могут меняться со временем. Чтобы избежать ненужных проблем с подключением, следует прослушивать события XboxLiveDeviceAddress.SnapshotChanged по адресу локального устройства, чтобы узнать, когда было обновлено содержимое snapshot, и обновлять сериализованный snapshot в любом месте, где вы его передали или кэшировали, чтобы удаленные устройства всегда имели последнюю информацию.