XboxLiveQualityOfServiceMeasurement Classe

Definizione

Spazio dei nomi:

Windows.Networking.XboxLive

Descrive i parametri operativi di una misurazione QoS (Network Quality of Service) e fornisce l'accesso ai risultati di tali misurazioni.

Importante

Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

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

Ereditarietà

Object Platform::Object IInspectable XboxLiveQualityOfServiceMeasurement

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Xbox One System Apps Extensions for the UWP (è stato introdotto in 10.0.0.1) Xbox Live Extension SDK (è stato introdotto in 10.0.10240.0) Xbox One Extensions for the UWP (è stato introdotto in 10.0.10240.0) Windows Desktop Extension SDK (è stato introdotto in 10.0.16299.0)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (è stato introdotto in v1.0)

Costruttori

XboxLiveQualityOfServiceMeasurement()

Crea un oggetto XboxLiveQualityOfServiceMeasurement . Per eseguire una misurazione Quality of Service (QoS), creare un'istanza di questa classe, quindi impostare i parametri della misura usando i membri DeviceAddresses, Metrics, NumberOfProbesToAttempt, ShouldRequestPrivatePayloads e TimeoutInMilliseconds . Chiamare quindi MeasureAsync per avviare le misurazioni. È possibile eseguire query sui risultati mentre la misurazione è in corso oppure attendere il completamento dell'operazione e quindi eseguire query sui risultati finali. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

Proprietà

DeviceAddresses	Ottiene l'elenco di indirizzi da eseguire per il probe. Il contenuto dell'elenco può essere modificato usando i metodi di interfaccia IVector . Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
IsSystemInboundBandwidthConstrained	Ottiene o imposta un valore booleano che configura se le misurazioni QoS (Quality of Service) e altre operazioni di rete interne di Windows.Networking.XboxLive tentano di limitare il consumo di larghezza di banda in ingresso. Constraining consumption in questo modo riduce l'impatto di tali operazioni sull'utilizzo della larghezza di banda in ingresso dell'app, a spese di ritardi più lunghi o un aumento dei tassi di errore per loro. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
IsSystemOutboundBandwidthConstrained	Ottiene o imposta un valore booleano che configura se le misurazioni qualità del servizio (QoS) e altre operazioni di rete interna windows.Networking.XboxLive tentano di limitare il consumo della larghezza di banda in uscita. Constraining consumption in questo modo riduce l'impatto di tali operazioni sull'utilizzo della larghezza di banda in uscita dell'app, a spese di ritardi più lunghi o di un aumento dei tassi di errore per loro. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
MaxPrivatePayloadSize	Proprietà statica che ottiene il numero massimo di byte consentiti per i buffer del payload privato. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
MaxSimultaneousProbeConnections	Proprietà statica che ottiene o imposta il numero massimo di connessioni di probe di misura simultanee. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
MetricResults	Ottiene un elenco di tutte le metriche per tutti i dispositivi specificati nella misurazione QoS (Quality of Service) corrente. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
Metrics	Ottiene l'elenco delle metriche da misurare in questa misurazione QoS (Quality of Service). È possibile modificare l'elenco usando i metodi di interfaccia IVector . Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
NumberOfProbesToAttempt	Ottiene o imposta il numero di probe da tentare a ogni dispositivo durante l'esecuzione di questa misurazione QoS (Quality of Service). Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
NumberOfResultsPending	Ottiene il numero di risultati in sospeso per la misurazione QoS (Quality of Service) corrente mentre è in corso. È 0 se l'azione di misurazione è stata completata. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
PrivatePayloadResults	Ottiene un elenco di payload privati recuperati in questa misurazione QoS (Quality of Service). Si noti che i payload privati vengono recuperati solo quando la proprietà ShouldRequestPrivatePayloads è impostata su prima della chiamata a trueMeasureAsync . Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
PublishedPrivatePayload	Ottiene o imposta il payload privato pubblicato per il dispositivo locale. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
ShouldRequestPrivatePayloads	Ottiene o imposta un valore booleano che indica se i payload privati devono essere recuperati dai dispositivi coinvolti in questa misurazione QoS (Quality of Service). Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
TimeoutInMilliseconds	Ottiene o imposta il timeout per la misurazione QoS (Quality of Service). Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

Metodi

ClearPrivatePayload()	Cancella il payload privato stabilito con PublishPrivatePayloadBytes. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetMetricResult(XboxLiveDeviceAddress, XboxLiveQualityOfServiceMetric)	Ottiene i risultati della misurazione più recente di una determinata metrica sulla connessione a un determinato indirizzo. Il codice specifica un set di metriche, indirizzi del dispositivo, timeout e numero di probe da tentare e quindi chiama XboxLiveQualityOfServiceMeasurement.MeasureAsync per iniziare a eseguire le misurazioni specificate. È possibile chiamare GetMetricResult in qualsiasi momento mentre le misurazioni sono in corso o al termine e recuperarne il valore corrente. Si noti che se si chiama ripetutamente GetMetricResult per una determinata metrica mentre le misurazioni pertinenti sono in corso, è possibile ottenere valori diversi man mano che la misura procede. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetMetricResultsForDevice(XboxLiveDeviceAddress)	Ottiene tutti i risultati delle metriche per un determinato dispositivo. Il codice specifica un set di metriche, indirizzi del dispositivo, timeout e numero di probe da tentare e quindi chiama XboxLiveQualityOfServiceMeasurement.MeasureAsync per iniziare a eseguire le misurazioni specificate. È possibile chiamare GetMetricResultsForDevice in qualsiasi momento mentre le misurazioni sono in corso o al termine e recuperare i valori correnti. Si noti che se si chiama ripetutamente GetMetricResultsForDevice e si esamina una determinata metrica mentre le misurazioni pertinenti sono in corso, è possibile ottenere valori diversi man mano che la misurazione procede. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetMetricResultsForMetric(XboxLiveQualityOfServiceMetric)	Ottiene i valori più recenti di una determinata metrica, in tutti i dispositivi misurati. Il codice specifica un set di metriche, indirizzi del dispositivo, timeout e numero di probe da tentare e quindi chiama XboxLiveQualityOfServiceMeasurement.MeasureAsync per iniziare a eseguire le misurazioni specificate. È possibile chiamare GetMetricResultsForMetric in qualsiasi momento mentre le misurazioni sono in corso o al termine e recuperare i valori correnti. Si noti che se si chiama ripetutamente GetMetricResultsForMetric. e controllare una determinata metrica per un determinato dispositivo mentre le misurazioni pertinenti sono in corso, è possibile ottenere valori diversi man mano che la misura procede. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetPrivatePayloadResult(XboxLiveDeviceAddress)	Ottiene il payload privato per un dispositivo attualmente misurato, se ShouldRequestPrivatePayloads è stato impostato su true per questa misurazione. Il codice specifica un set di metriche, indirizzi del dispositivo, timeout, numero di probe da tentare e se richiedere payload privati e quindi chiama XboxLiveQualityOfServiceMeasurement.MeasureAsync per iniziare a eseguire le misurazioni specificate e recuperare eventuali payload privati. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
MeasureAsync()	Avvia le misurazioni Quality of Service (QoS) come specificato dalle proprietà di questa istanza. Il codice può recuperare i risultati correnti della misurazione non appena questo metodo è stato chiamato, prima che tutte le misurazioni siano state completate. Le metriche recuperate possono cambiare in qualsiasi momento, purché la misurazione sia ancora in corso. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
PublishPrivatePayloadBytes(Byte[])	Imposta il payload privato restituito quando una query host remota per il payload privato. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.