Freigeben über


SetSocketMediaStreamingMode-Funktion (socketapi.h)

Die SetSocketMediaStreamingMode-Funktion gibt an, ob das Netzwerk für die Übertragung von Streamingmedien verwendet werden soll, die eine Dienstqualität erfordern.

Syntax

HRESULT SetSocketMediaStreamingMode(
  BOOL value
);

Parameter

value

Gibt an, ob das Netzwerk für die Übertragung von Streamingmedien verwendet werden soll, die eine Dienstqualität erfordern. Dadurch wird sichergestellt, dass so geöffnete Sockets mit geringer Latenz die richtige Dienstqualität über 802.11-Drahtlosnetzwerke erhalten.

Rückgabewert

Wenn kein Fehler auftritt, gibt SetSocketMediaStreamingMode S_OK zurück. Andernfalls wird ein Fehlercode als HRESULT zurückgegeben.

Hinweise

Die SetSocketMediaStreamingMode-Funktion wird verwendet, um anzugeben, ob das Netzwerk für die Übertragung von Streamingmedien verwendet werden soll, die eine Dienstqualität erfordern. Diese Funktion wird normalerweise von VoIP (Voice over IP) oder ähnlichen Apps verwendet, die eine konsistente Dienstqualität erfordern. Die SetSocketMediaStreamingMode-Funktion kann von Windows Store-Apps oder Desktop-Apps verwendet werden.

Bei Verwendung über ein 802.11-Drahtlosnetzwerk können Probleme mit der Dienstqualität für das Medienstreaming auftreten. Der 802.11-Netzwerktreiber sucht regelmäßig nach anderen Infrastrukturnetzwerken (ESS) oder Ad-hoc-Netzwerken (IBSS). Dadurch kann der Drahtlosnetzwerkadapter andere Netzwerke finden und möglicherweise mit einem Netzwerk mit einem stärkeren Signal verbunden sein. Die meisten aktuellen 802.11-Netzwerktreiber scannen alle verfügbaren Kanäle als Serie auf einmal. Wenn der Netzwerktreiber 802.11 nach anderen Netzwerken sucht und auf anderen Kanälen lauscht, kann er keine Pakete für die App empfangen. Die Überprüfungszeit für andere Netzwerke kann zu einer spürbaren Lücke (100 Millisekunden oder mehr) führen, wenn eine VoIP-App den Audiodatenstrom nicht empfangen kann. Dieser Scanvorgang ist für 802.11-Netzwerkadapter mit Dualband (2,4 GHz und 5 GHz) länger, da noch mehr Kanäle gescannt werden. Dies kann dazu führen, dass das Audio als stottern empfunden wird.

Wenn die SetSocketMediaStreamingMode-Funktion aufgerufen wird, wobei der Wertparameter auf TRUE festgelegt ist und der Socket über einen 802.11-Drahtlosnetzwerkadapter übertragen wird, benachrichtigt das System den Drahtlosnetzwerktreiber, die Überprüfung nach anderen Netzwerken zu beenden. Dadurch wird das Stottern durch VoIP und ähnliche Audio-Apps bei Verwendung über 802.11-Drahtlosnetzwerke vermieden, aber auch alle Apps, die auf dem lokalen Computer oder Gerät ausgeführt werden.

Es gibt Fälle, in denen das Deaktivieren von Scans Probleme verursachen kann. Wenn Scans deaktiviert werden, bleibt der lokale Computer mit demselben Netzwerk verbunden, auch wenn das Signal schwächer und schwächer wird, wenn sich der Benutzer vom Netzwerk entfernt.

Eine VoIP-App oder eine ähnliche App sollte alle Sockets mit geringer Latenz schließen, um den Medienstreamingmodus des 802.11-Drahtlosnetzwerktreibers wiederherzustellen. Dadurch wird die Überprüfung für andere drahtlose Netzwerke erneut aktiviert.

Die SetSocketMediaStreamingMode-Funktion hat keine Auswirkungen, wenn der Socket keine Pakete über einen 802.11-Funkadapter sendet oder empfängt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile socketapi.h
Bibliothek Windows.Networking.lib
DLL Windows.Networking.dll

Weitere Informationen

Hinzufügen von Netzwerkunterstützung

Windows.Networking.BackgroundTransfer

Windows.Networking.Sockets