XboxLiveQualityOfServiceMeasurement Classe
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.
Descreve os parâmetros operacionais de uma medida de QoS (Qualidade de Serviço) de rede e fornece acesso aos resultados dessas medidas.
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 ref class XboxLiveQualityOfServiceMeasurement sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Networking.XboxLive.XboxLiveSecureSocketsContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class XboxLiveQualityOfServiceMeasurement final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Networking.XboxLive.XboxLiveSecureSocketsContract")]
class XboxLiveQualityOfServiceMeasurement final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class XboxLiveQualityOfServiceMeasurement
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Networking.XboxLive.XboxLiveSecureSocketsContract")]
public sealed class XboxLiveQualityOfServiceMeasurement
function XboxLiveQualityOfServiceMeasurement()
Public NotInheritable Class XboxLiveQualityOfServiceMeasurement
- Herança
- Atributos
Requisitos do Windows
Família de dispositivos |
Xbox One System Apps Extensions for the UWP (introduzida na 10.0.0.1)
Xbox Live Extension SDK (introduzida na 10.0.10240.0) Xbox One Extensions for the UWP (introduzida na 10.0.10240.0) Windows Desktop Extension SDK (introduzida na 10.0.16299.0) |
API contract |
Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (introduzida na v1.0)
|
Construtores
XboxLiveQualityOfServiceMeasurement() |
Cria um objeto XboxLiveQualityOfServiceMeasurement . Para executar uma medida de QoS (Qualidade de Serviço), crie uma instância dessa classe e defina os parâmetros da medida usando os membros DeviceAddresses, Metrics, NumberOfProbesToAttempt, ShouldRequestPrivatePayloads e TimeoutInMilliseconds . Em seguida, chame MeasureAsync para iniciar medidas. Você pode consultar os resultados enquanto a medida está em andamento ou pode aguardar até que a operação seja concluída e consultar os resultados finais. 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. |
Propriedades
DeviceAddresses |
Obtém a lista de endereços a serem investigados. O conteúdo da lista pode ser alterado usando métodos de interface IVector . 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. |
IsSystemInboundBandwidthConstrained |
Obtém ou define um valor booliano que configura se medidas de QoS (Qualidade de Serviço) e outras operações de rede internas Windows.Networking.XboxLive tentam restringir seu consumo de largura de banda de entrada. Restringir o consumo dessa forma reduz o impacto dessas operações no uso de largura de banda de entrada do seu aplicativo, em detrimento de atrasos mais longos ou aumento das taxas de falha para elas. 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. |
IsSystemOutboundBandwidthConstrained |
Obtém ou define um valor booliano que configura se as medidas de QoS (Qualidade de Serviço) e outras operações de rede internas do Windows.Networking.XboxLive tentam restringir o consumo de largura de banda de saída. Restringir o consumo dessa forma reduz o impacto dessas operações no uso de largura de banda de saída do aplicativo, em detrimento de atrasos mais longos ou taxas de falha aumentadas para elas. 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. |
MaxPrivatePayloadSize |
Propriedade estática que obtém o número máximo de bytes permitidos para buffers de conteúdo privado. 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. |
MaxSimultaneousProbeConnections |
Propriedade estática que obtém ou define o número máximo de conexões de investigação de medida simultânea. 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. |
MetricResults |
Obtém uma lista de todas as métricas para todos os dispositivos especificados na medida de QoS (Qualidade de Serviço) atual. 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. |
Metrics |
Obtém a lista das métricas a serem medidas nesta medida de QoS (Qualidade de Serviço). Você pode modificar a lista usando métodos de interface IVector . 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. |
NumberOfProbesToAttempt |
Obtém ou define o número de investigações a tentar para cada dispositivo ao executar essa medida de QoS (Qualidade de Serviço). 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. |
NumberOfResultsPending |
Obtém o número de resultados pendentes para a medida de QoS (Qualidade de Serviço) atual enquanto ela está em andamento. Será 0 se a ação de medição tiver sido concluída. 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. |
PrivatePayloadResults |
Obtém uma lista de cargas privadas que foram recuperadas nesta medida de QoS (Qualidade de Serviço). Observe que as cargas privadas são recuperadas somente quando a propriedade ShouldRequestPrivatePayloads é definida 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. |
PublishedPrivatePayload |
Obtém ou define o conteúdo privado publicado para o dispositivo local. 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. |
ShouldRequestPrivatePayloads |
Obtém ou define um valor booliano que indica se as cargas privadas devem ser recuperadas dos dispositivos envolvidos nessa medida de QoS (Qualidade de Serviço). 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. |
TimeoutInMilliseconds |
Obtém ou define o tempo limite para essa medida de QoS (Qualidade de Serviço). 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. |
Métodos
ClearPrivatePayload() |
Limpa o conteúdo privado estabelecido com PublishPrivatePayloadBytes. 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. |
GetMetricResult(XboxLiveDeviceAddress, XboxLiveQualityOfServiceMetric) |
Obtém os resultados da medida mais recente de uma determinada métrica na conexão com um determinado endereço. Seu código especifica um conjunto de métricas, endereços de dispositivo, tempos limite e número de investigações a serem tentadas e, em seguida, chama XboxLiveQualityOfServiceMeasurement.MeasureAsync para começar a fazer as medidas especificadas. Você pode chamar GetMetricResult a qualquer momento enquanto as medidas estiverem em andamento ou após a conclusão e recuperar seu valor atual. Observe que, se você chamar GetMetricResult repetidamente para uma determinada métrica enquanto as medidas relevantes estiverem em andamento, poderá obter valores diferentes à medida que a medida prossegue. 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. |
GetMetricResultsForDevice(XboxLiveDeviceAddress) |
Obtém todos os resultados da métrica para um determinado dispositivo. Seu código especifica um conjunto de métricas, endereços de dispositivo, tempos limite e número de investigações a serem tentadas e, em seguida, chama XboxLiveQualityOfServiceMeasurement.MeasureAsync para começar a fazer as medidas especificadas. Você pode chamar GetMetricResultsForDevice a qualquer momento enquanto as medidas estiverem em andamento ou após a conclusão e recuperar os valores atuais. Observe que, se você chamar GetMetricResultsForDevice repetidamente e inspecionar uma determinada métrica enquanto as medidas relevantes estiverem em andamento, você poderá obter valores diferentes à medida que a medida prossegue. 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. |
GetMetricResultsForMetric(XboxLiveQualityOfServiceMetric) |
Obtém os valores mais recentes de uma determinada métrica, em todos os dispositivos que estão sendo medidos. Seu código especifica um conjunto de métricas, endereços de dispositivo, tempos limite e número de investigações a serem tentadas e, em seguida, chama XboxLiveQualityOfServiceMeasurement.MeasureAsync para começar a fazer as medidas especificadas. Você pode chamar GetMetricResultsForMetric a qualquer momento enquanto as medidas estiverem em andamento ou após a conclusão e recuperar os valores atuais. Observe que, se você chamar GetMetricResultsForMetric repetidamente. e inspecionar uma determinada métrica para um determinado dispositivo enquanto as medidas relevantes estão em andamento, você pode obter valores diferentes à medida que a medida prossegue. 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. |
GetPrivatePayloadResult(XboxLiveDeviceAddress) |
Obtém o conteúdo privado de um dispositivo que está sendo medido no momento, se ShouldRequestPrivatePayloads foi definido Seu código especifica um conjunto de métricas, endereços de dispositivo, tempos limite, número de investigações a serem tentadas e se deve solicitar conteúdo privado e, em seguida, chama XboxLiveQualityOfServiceMeasurement.MeasureAsync para começar a fazer as medições especificadas e recuperar quaisquer cargas privadas. 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. |
MeasureAsync() |
Inicia medidas de QoS (Qualidade de Serviço), conforme especificado pelas propriedades dessa instância. Seu código pode recuperar os resultados da medida atual assim que esse método for chamado, antes que todas as medidas sejam concluídas. As métricas recuperadas podem ser alteradas a qualquer momento, desde que uma medida ainda esteja em andamento. 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. |
PublishPrivatePayloadBytes(Byte[]) |
Define o conteúdo privado retornado quando um host remoto consulta o conteúdo privado. 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. |