XboxLiveDeviceAddress.GetSnapshotAsBytes(Byte[], UInt32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Guarda una XboxLiveDeviceAddress en una matriz de bytes.
Puedes usar este método para guardar una instantánea para usarla con el método XboxLiveDeviceAddress.CreateFromSnapshotBytes .
Importante
Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
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[]
Matriz de bytes que se va a recibir la instantánea.
Usa la propiedad XboxLiveDeviceAddress.MaxSnapshotBytesSize para determinar el tamaño adecuado de la matriz que pasas.
- bytesWritten
-
UInt32
unsigned int
uint32_t
Al finalizar correctamente, el número de bytes de la instantánea. En caso de error, -1.
Comentarios
Las instantáneas son formas serializadas de objetos XboxLiveDeviceAddress que se pueden transmitir a dispositivos remotos a través de canales fuera de banda, como el emparejamiento de Xbox Live. Sin embargo, representan la información de direcciones de red de un dispositivo en un momento determinado y pueden cambiar con el tiempo. Para evitar problemas de conectividad innecesarios, debes escuchar eventos XboxLiveDeviceAddress.SnapshotChanged en la dirección del dispositivo local para saber cuándo se ha actualizado su contenido de instantáneas y actualizar la instantánea serializada en cualquier lugar en el que hayas transmitido o almacenado en caché, de modo que los dispositivos remotos siempre tengan la información más reciente.