通过

XboxLiveDeviceAddress.GetSnapshotAsBytes(Byte[], UInt32) 方法

  • 参考

定义

命名空间:
Windows.Networking.XboxLive
编辑

将 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。

注解

快照是 XboxLiveDeviceAddress 对象的序列化形式，可以通过带外通道（如 Xbox Live 匹配）传输到远程设备。 但是，它们表示设备在特定时间的网络地址信息，并且可能会随时间而更改。 若要避免不必要的连接问题，应侦听本地设备地址上的 XboxLiveDeviceAddress.SnapshotChanged 事件，以了解其快照内容已更新的时间，并刷新已序列化快照，以便远程设备始终获取最新信息。

适用于