XboxLiveQualityOfServiceMeasurement Klasse

Definition

Namespace:

Windows.Networking.XboxLive

Beschreibt die Betriebsparameter einer QoS-Messung (Quality of Service) des Netzwerks und bietet Zugriff auf die Ergebnisse solcher Messungen.

Wichtig

Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.

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

Vererbung

Object Platform::Object IInspectable XboxLiveQualityOfServiceMeasurement

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Xbox One System Apps Extensions for the UWP (eingeführt in 10.0.0.1) Xbox Live Extension SDK (eingeführt in 10.0.10240.0) Xbox One Extensions for the UWP (eingeführt in 10.0.10240.0) Windows Desktop Extension SDK (eingeführt in 10.0.16299.0)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (eingeführt in v1.0)

Konstruktoren

XboxLiveQualityOfServiceMeasurement()

Erstellt ein XboxLiveQualityOfServiceMeasurement-Objekt . Um eine QoS-Messung (Quality of Service) durchzuführen, erstellen Sie eine instance dieser Klasse, und legen Sie dann die Parameter der Messung mithilfe der Member DeviceAddresses, Metrics, NumberOfProbesToAttempt, ShouldRequestPrivatePayloads und TimeoutInMilliseconds fest. Rufen Sie dann MeasureAsync auf, um Messungen zu initiieren. Sie können Ergebnisse abfragen, während die Messung ausgeführt wird, oder Sie können warten, bis der Vorgang abgeschlossen ist, und dann die endgültigen Ergebnisse abfragen. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.

Eigenschaften

DeviceAddresses	Ruft die Liste der zu überprüfenden Adressen ab. Der Inhalt der Liste kann mithilfe von IVector-Schnittstellenmethoden geändert werden. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
IsSystemInboundBandwidthConstrained	Ruft einen booleschen Wert ab, der konfiguriert, ob QoS-Messungen (Quality of Service) und andere interne Windows.Networking.XboxLive-Netzwerkvorgänge versuchen, den Bandbreitenverbrauch für eingehenden Datenverkehr einzuschränken, oder legt diesen fest. Wenn Sie den Verbrauch auf diese Weise einschränken, werden die Auswirkungen dieser Vorgänge auf die Bandbreitennutzung Ihrer App für eingehenden Datenverkehr verringert, was zu lasten längerer Verzögerungen oder erhöhter Fehlerraten für sie ist. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
IsSystemOutboundBandwidthConstrained	Ruft einen booleschen Wert ab, der konfiguriert, ob QoS-Messungen (Quality of Service) und andere interne Windows.Networking.XboxLive-Netzwerkvorgänge versuchen, die ausgehende Bandbreitennutzung einzuschränken, oder legt diesen fest. Wenn Sie den Verbrauch auf diese Weise einschränken, werden die Auswirkungen dieser Vorgänge auf die ausgehende Bandbreitennutzung Ihrer App verringert, was zu lasten längerer Verzögerungen oder höherer Fehlerraten für sie ist. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
MaxPrivatePayloadSize	Statische Eigenschaft, die die maximale Anzahl von Bytes abruft, die für private Nutzlastpuffer zulässig sind. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
MaxSimultaneousProbeConnections	Statische Eigenschaft, die die maximale Anzahl gleichzeitiger Messtestverbindungen abruft oder festlegt. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
MetricResults	Ruft eine Liste aller Metriken für alle Geräte ab, die in der aktuellen QoS-Messung (Quality of Service) angegeben sind. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
Metrics	Ruft die Liste der Metriken ab, die in dieser QoS-Messung (Quality of Service) gemessen werden sollen. Sie können die Liste mithilfe von IVector-Schnittstellenmethoden ändern. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
NumberOfProbesToAttempt	Ruft die Anzahl der Tests ab, die bei der Durchführung dieser QoS-Messung (Quality of Service) für jedes Gerät versucht werden sollen, oder legt diese fest. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
NumberOfResultsPending	Ruft die Anzahl der ausstehenden Ergebnisse für die aktuelle QoS-Messung (Quality of Service) ab, während sie ausgeführt wird. Er ist 0, wenn die Messaktion abgeschlossen ist. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
PrivatePayloadResults	Ruft eine Liste der privaten Nutzlasten ab, die in dieser QoS-Messung (Quality of Service) abgerufen wurden. Beachten Sie, dass private Nutzlasten nur abgerufen werden, wenn die ShouldRequestPrivatePayloads-Eigenschaft auf festgelegt ist, true bevor MeasureAsync aufgerufen wird. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
PublishedPrivatePayload	Ruft die private Nutzlast ab, die für das lokale Gerät veröffentlicht wurde, oder legt diese fest. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
ShouldRequestPrivatePayloads	Ruft einen booleschen Wert ab, der angibt, ob private Nutzlasten von den Geräten abgerufen werden sollen, die an dieser QoS-Messung (Quality of Service) beteiligt sind, oder legt diesen fest. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
TimeoutInMilliseconds	Ruft das Timeout für diese QoS-Messung (Quality of Service) ab oder legt dieses fest. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.

Methoden

ClearPrivatePayload()	Löscht die private Nutzlast, die mit PublishPrivatePayloadBytes eingerichtet wurde. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
GetMetricResult(XboxLiveDeviceAddress, XboxLiveQualityOfServiceMetric)	Ruft die Ergebnisse der letzten Messung einer angegebenen Metrik für die Verbindung mit einer angegebenen Adresse ab. Ihr Code gibt eine Reihe von Metriken, Geräteadressen, Timeouts und die Anzahl der zu versuchenden Tests an und ruft dann XboxLiveQualityOfServiceMeasurement.MeasureAsync auf, um mit der Ausführung der angegebenen Messungen zu beginnen. Sie können GetMetricResult jederzeit aufrufen, während die Messungen ausgeführt werden oder nachdem sie abgeschlossen sind, und den aktuellen Wert abrufen. Wenn Sie GetMetricResult für eine bestimmte Metrik wiederholt aufrufen, während die relevanten Messungen ausgeführt werden, erhalten Sie möglicherweise andere Werte, wenn die Messung fortgesetzt wird. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
GetMetricResultsForDevice(XboxLiveDeviceAddress)	Ruft alle Metrikergebnisse für ein bestimmtes Gerät ab. Ihr Code gibt eine Reihe von Metriken, Geräteadressen, Timeouts und die Anzahl der zu versuchenden Tests an und ruft dann XboxLiveQualityOfServiceMeasurement.MeasureAsync auf, um mit der Ausführung der angegebenen Messungen zu beginnen. Sie können GetMetricResultsForDevice jederzeit aufrufen, während die Messungen ausgeführt werden oder nachdem sie abgeschlossen sind, und aktuelle Werte abrufen. Wenn Sie GetMetricResultsForDevice wiederholt aufrufen und eine bestimmte Metrik untersuchen, während die relevanten Messungen ausgeführt werden, erhalten Sie möglicherweise andere Werte, wenn die Messung fortgesetzt wird. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
GetMetricResultsForMetric(XboxLiveQualityOfServiceMetric)	Ruft die neuesten Werte einer angegebenen Metrik auf allen geräten ab, die gemessen werden. Ihr Code gibt eine Reihe von Metriken, Geräteadressen, Timeouts und die Anzahl der zu versuchenden Tests an und ruft dann XboxLiveQualityOfServiceMeasurement.MeasureAsync auf, um mit der Ausführung der angegebenen Messungen zu beginnen. Sie können GetMetricResultsForMetric jederzeit aufrufen, während die Messungen ausgeführt werden oder nachdem sie abgeschlossen sind, und aktuelle Werte abrufen. Beachten Sie folgendes, wenn Sie GetMetricResultsForMetric wiederholt aufrufen. und untersuchen Sie eine bestimmte Metrik für ein bestimmtes Gerät, während die relevanten Messungen ausgeführt werden. Während die Messung fortgesetzt wird, erhalten Sie möglicherweise unterschiedliche Werte. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
GetPrivatePayloadResult(XboxLiveDeviceAddress)	Ruft die private Nutzlast für ein Gerät ab, das derzeit gemessen wird, wenn Für diese Messung "ShouldRequestPrivatePayloads " auf true festgelegt wurde. Ihr Code gibt eine Reihe von Metriken, Geräteadressen, Timeouts, die Anzahl der zu versuchenden Tests an und gibt an, ob private Nutzlasten angefordert werden sollen, und ruft dann XboxLiveQualityOfServiceMeasurement.MeasureAsync auf, um mit der Ausführung der angegebenen Messungen zu beginnen und alle privaten Nutzlasten abzurufen. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
MeasureAsync()	Initiiert QoS-Messungen (Quality of Service), wie in den Eigenschaften dieses instance angegeben. Ihr Code kann aktuelle Messergebnisse abrufen, sobald diese Methode aufgerufen wurde, bevor alle Messungen abgeschlossen sind. Die abgerufenen Metriken können jederzeit geändert werden, solange noch eine Messung ausgeführt wird. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
PublishPrivatePayloadBytes(Byte[])	Legt die private Nutzlast fest, die zurückgegeben wird, wenn ein Remotehost die private Nutzlast abfragt. Wichtig Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.