Поделиться через


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 в любом месте, где вы его передали или кэшировали, чтобы удаленные устройства всегда имели последнюю информацию.

Применяется к