Funzione SetSocketMediaStreamingMode (socketapi.h)

La funzione SetSocketMediaStreamingMode indica se la rete deve essere usata per il trasferimento di supporti di streaming che richiedono qualità del servizio.

Sintassi

HRESULT SetSocketMediaStreamingMode(
  BOOL value
);

Parametri

value

Indica se la rete deve essere usata per il trasferimento di supporti di streaming che richiedono la qualità del servizio. Ciò garantisce che i socket aperti come bassa latenza otterranno la qualità corretta del servizio su reti wireless 802.11.

Valore restituito

Se non si verifica alcun errore, SetSocketMediaStreamingMode restituisce S_OK. In caso contrario, viene restituito un codice di errore come HRESULT.

Commenti

La funzione SetSocketMediaStreamingMode viene usata per indicare se la rete deve essere usata per il trasferimento di supporti di streaming che richiedono qualità del servizio. Questa funzione viene normalmente usata da Voice over IP (VoIP) o da app simili che richiedono una qualità coerente del servizio. La funzione SetSocketMediaStreamingMode può essere usata dalle app di Windows Store o dalle app desktop.

Possono verificarsi problemi di qualità del servizio per lo streaming multimediale quando viene usato su una rete wireless 802.11. Il driver di rete 802.11 eseguirà periodicamente l'analisi di altre reti di infrastruttura vicine (ESS) o reti ad hoc (IBSS). Ciò consente alla scheda di rete wireless di trovare altre reti e possibilmente connessa a una rete con un segnale più forte. La maggior parte dei driver di rete correnti 802.11 analizza tutti i canali disponibili come serie contemporaneamente. Quando il driver di rete 802.11 esegue l'analisi di altre reti e l'ascolto su altri canali, non può ricevere pacchetti per l'app. Il tempo impiegato per l'analisi per altre reti può introdurre un divario evidente (100 millisecondi o più) quando un'app VoIP non sarebbe in grado di ricevere il flusso audio. Questo processo di analisi è più lungo per 802.11 schede di rete che sono a doppia banda (2,4GHz e 5GHz) perché vengono analizzati ancora più canali. Ciò può comportare la percezione dell'audio come stuttering.

Quando la funzione SetSocketMediaStreamingMode viene chiamata con il parametro valore impostato su TRUE e il socket verrà trasferito su una scheda di rete wireless 802.11, il sistema notifica al driver di rete wireless di interrompere l'analisi per altre reti. Ciò elimina lo stuttering da VoIP e app audio simili quando vengono usate oltre 802.11 reti wireless, ma influisce anche su tutte le app in esecuzione nel computer locale o nel dispositivo.

Esistono casi in cui la disattivazione delle analisi può causare problemi. Quando le analisi sono disabilitate, il computer locale rimane connesso alla stessa rete anche se il segnale diventa più debole e debole quando l'utente si allontana dalla rete.

Un'app VoIP o simile deve chiudere tutti i socket a bassa latenza per ripristinare la modalità di streaming multimediale del driver di rete wireless 802.11. In questo modo si riabiliterà la scansione per altre reti wireless.

La funzione SetSocketMediaStreamingMode non ha alcun effetto se il socket non invia o riceve pacchetti tramite una scheda wireless 802.11.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	socketapi.h
Libreria	Windows.Networking.lib
DLL	Windows.Networking.dll

Vedi anche

Aggiunta del supporto per la rete

Windows.Networking.BackgroundTransfer

Windows.Networking.Sockets