XboxLiveQualityOfServiceMeasurement Clase

Definición

Espacio de nombres:

Windows.Networking.XboxLive

Describe los parámetros operativos de una medida de calidad de servicio (QoS) de red y proporciona acceso a los resultados de dichas mediciones.

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 ref class XboxLiveQualityOfServiceMeasurement sealed

/// [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.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

Herencia

Object Platform::Object IInspectable XboxLiveQualityOfServiceMeasurement

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Xbox One System Apps Extensions for the UWP (se introdujo en la versión 10.0.0.1) Xbox Live Extension SDK (se introdujo en la versión 10.0.10240.0) Xbox One Extensions for the UWP (se introdujo en la versión 10.0.10240.0) Windows Desktop Extension SDK (se introdujo en la versión 10.0.16299.0)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (se introdujo en la versión v1.0)

Constructores

XboxLiveQualityOfServiceMeasurement()

Crea un objeto XboxLiveQualityOfServiceMeasurement . Para realizar una medición de calidad de servicio (QoS), cree una instancia de esta clase y, a continuación, establezca los parámetros de la medida mediante los miembros DeviceAddresses, Metrics, NumberOfProbesToAttempt, ShouldRequestPrivatePayloads y TimeoutInMilliseconds . A continuación, llame a MeasureAsync para iniciar medidas. Puede consultar los resultados mientras la medida está en curso, o puede esperar hasta que finalice la operación y, a continuación, consultar los resultados finales. 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.

Propiedades

DeviceAddresses	Obtiene la lista de direcciones que se van a sondear. El contenido de la lista se puede cambiar mediante métodos de interfaz IVector . 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.
IsSystemInboundBandwidthConstrained	Obtiene o establece un valor booleano que configura si las medidas de calidad de servicio (QoS) y otras operaciones de red internas de Windows.Networking.XboxLive intentan restringir su consumo de ancho de banda entrante. Restringir el consumo de esta manera reduce el impacto de esas operaciones en el uso de ancho de banda entrante de la aplicación, a costa de retrasos más largos o mayores tasas de error para ellas. 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.
IsSystemOutboundBandwidthConstrained	Obtiene o establece un valor booleano que configura si las medidas de calidad de servicio (QoS) y otras operaciones de red internas de Windows.Networking.XboxLive intentan restringir su consumo de ancho de banda saliente. Restringir el consumo de esta manera reduce el impacto de esas operaciones en el uso de ancho de banda saliente de la aplicación, a costa de retrasos más largos o mayores tasas de error para ellas. 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.
MaxPrivatePayloadSize	Propiedad estática que obtiene el número máximo de bytes permitidos para los búferes de carga privada. 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.
MaxSimultaneousProbeConnections	Propiedad estática que obtiene o establece el número máximo de conexiones de sondeo de medida simultáneas. 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.
MetricResults	Obtiene una lista de todas las métricas de todos los dispositivos especificados en la medida actual calidad de servicio (QoS). 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.
Metrics	Obtiene la lista de las métricas que se van a medir en esta medida de calidad de servicio (QoS). Puede modificar la lista mediante métodos de interfaz IVector . 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.
NumberOfProbesToAttempt	Obtiene o establece el número de sondeos que se intentarán en cada dispositivo mientras se realiza esta medición de calidad de servicio (QoS). 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.
NumberOfResultsPending	Obtiene el número de resultados pendientes para la medición actual de calidad de servicio (QoS) mientras está en curso. Es 0 si se ha completado la acción de medición. 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.
PrivatePayloadResults	Obtiene una lista de cargas privadas que se han recuperado en esta medida de calidad de servicio (QoS). Tenga en cuenta que las cargas privadas solo se recuperan cuando se establece la propiedad ShouldRequestPrivatePayloads en true antes de llamar a MeasureAsync . 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.
PublishedPrivatePayload	Obtiene o establece la carga privada publicada para el dispositivo local. 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.
ShouldRequestPrivatePayloads	Obtiene o establece un valor booleano que indica si se deben recuperar cargas privadas de los dispositivos implicados en esta medida de calidad de servicio (QoS). 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.
TimeoutInMilliseconds	Obtiene o establece el tiempo de espera de esta medida de calidad de servicio (QoS). 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.

Métodos

ClearPrivatePayload()	Borra la carga privada establecida con PublishPrivatePayloadBytes. 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.
GetMetricResult(XboxLiveDeviceAddress, XboxLiveQualityOfServiceMetric)	Obtiene los resultados de la medida más reciente de una métrica determinada en la conexión a una dirección determinada. El código especifica un conjunto de métricas, direcciones de dispositivo, tiempos de espera y número de sondeos que se van a intentar y, a continuación, llama a XboxLiveQualityOfServiceMeasurement.MeasureAsync para empezar a realizar las medidas especificadas. Puede llamar a GetMetricResult en cualquier momento mientras las medidas estén en curso o después de que hayan finalizado y recuperen su valor actual. Tenga en cuenta que si llama repetidamente a GetMetricResult para una métrica determinada mientras las medidas pertinentes están en curso, es posible que obtenga valores diferentes a medida que continúe la medición. 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.
GetMetricResultsForDevice(XboxLiveDeviceAddress)	Obtiene todos los resultados de métricas de un dispositivo determinado. El código especifica un conjunto de métricas, direcciones de dispositivo, tiempos de espera y número de sondeos que se van a intentar y, a continuación, llama a XboxLiveQualityOfServiceMeasurement.MeasureAsync para empezar a realizar las medidas especificadas. Puede llamar a GetMetricResultsForDevice en cualquier momento mientras las medidas estén en curso o después de que hayan finalizado y recuperen los valores actuales. Tenga en cuenta que si llama repetidamente a GetMetricResultsForDevice e inspecciona una métrica determinada mientras las medidas pertinentes están en curso, puede obtener valores diferentes a medida que la medida continúa. 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.
GetMetricResultsForMetric(XboxLiveQualityOfServiceMetric)	Obtiene los valores más recientes de una métrica determinada, en todos los dispositivos que se miden. El código especifica un conjunto de métricas, direcciones de dispositivo, tiempos de espera y número de sondeos que se van a intentar y, a continuación, llama a XboxLiveQualityOfServiceMeasurement.MeasureAsync para empezar a realizar las medidas especificadas. Puede llamar a GetMetricResultsForMetric en cualquier momento mientras las medidas estén en curso o después de que hayan finalizado y recuperen los valores actuales. Tenga en cuenta que si llama repetidamente a GetMetricResultsForMetric. e inspeccione una métrica determinada para un dispositivo determinado mientras las medidas pertinentes están en curso, es posible que obtenga valores diferentes a medida que avanza la medición. 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.
GetPrivatePayloadResult(XboxLiveDeviceAddress)	Obtiene la carga privada de un dispositivo que se mide actualmente, si ShouldRequestPrivatePayloads se estableció true en para esta medida. El código especifica un conjunto de métricas, direcciones de dispositivo, tiempos de espera, número de sondeos que se van a intentar y si se solicitan cargas privadas y, a continuación, llama a XboxLiveQualityOfServiceMeasurement.MeasureAsync para empezar a realizar las medidas especificadas y para recuperar las cargas privadas. 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.
MeasureAsync()	Inicia las medidas de calidad de servicio (QoS) según lo especificado por las propiedades de esta instancia. El código puede recuperar los resultados de medición actuales en cuanto se haya llamado a este método, antes de que se hayan completado todas las medidas. Las métricas que recupere pueden cambiar en cualquier momento, siempre y cuando una medida siga en curso. 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.
PublishPrivatePayloadBytes(Byte[])	Establece la carga privada que se devuelve cuando un host remoto consulta la carga privada. 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.