Compartilhar via


XboxLiveQualityOfServiceMeasurement Classe

Definição

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
Object Platform::Object IInspectable XboxLiveQualityOfServiceMeasurement
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 true como antes de MeasureAsync ser chamado.

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 true como para essa medida.

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.

Aplica-se a