XboxLiveDeviceAddress.GetSnapshotAsBytes(Byte[], UInt32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Salva um XboxLiveDeviceAddress em uma matriz de bytes.
Você pode usar esse método para salvar um instantâneo para uso com o método XboxLiveDeviceAddress.CreateFromSnapshotBytes.
Importante
Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
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)Parâmetros
- buffer
-
Byte[]
byte[]
A matriz de bytes a receber o instantâneo.
Use a propriedade XboxLiveDeviceAddress.MaxSnapshotBytesSize para determinar o tamanho adequado da matriz que você passa.
- bytesWritten
-
UInt32
unsigned int
uint32_t
Após a conclusão bem-sucedida, o número de bytes no instantâneo. Em caso de falha, -1.
Comentários
Instantâneos são formas serializadas de objetos XboxLiveDeviceAddress que podem ser transmitidos para dispositivos remotos por meio de canais fora de banda, como a realização de correspondências do Xbox Live. No entanto, eles representam as informações de endereço de rede de um dispositivo em um determinado momento e podem ser alterados ao longo do tempo. Para evitar problemas de conectividade desnecessários, você deve escutar os eventos XboxLiveDeviceAddress.SnapshotChanged no endereço do dispositivo local para saber quando seu conteúdo instantâneo foi atualizado e atualizar o instantâneo serializado em qualquer lugar em que você o tenha transmitido ou armazenado em cache, para que os dispositivos remotos sempre tenham as informações mais recentes.