Fungsi SetSocketMediaStreamingMode (socketapi.h)

Fungsi SetSocketMediaStreamingMode menunjukkan apakah jaringan akan digunakan untuk mentransfer media streaming yang membutuhkan kualitas layanan.

Sintaks

HRESULT SetSocketMediaStreamingMode(
  BOOL value
);

Parameter

value

Menunjukkan apakah jaringan akan digunakan untuk mentransfer media streaming yang membutuhkan kualitas layanan. Ini memastikan bahwa soket yang dibuka karena latensi rendah akan mendapatkan kualitas layanan yang tepat di atas jaringan nirkabel 802.11.

Nilai kembali

Jika tidak ada kesalahan yang terjadi, SetSocketMediaStreamingMode mengembalikan S_OK. Jika tidak, kode kesalahan dikembalikan sebagai HRESULT.

Keterangan

Fungsi SetSocketMediaStreamingMode digunakan untuk menunjukkan apakah jaringan akan digunakan untuk mentransfer media streaming yang membutuhkan kualitas layanan. Fungsi ini biasanya digunakan oleh Voice over IP (VoIP) atau aplikasi serupa yang membutuhkan kualitas layanan yang konsisten. Fungsi SetSocketMediaStreamingMode dapat digunakan oleh aplikasi Windows Store atau aplikasi desktop.

Mungkin ada masalah kualitas layanan untuk streaming media ketika digunakan melalui jaringan nirkabel 802.11. Driver jaringan 802.11 akan secara berkala memindai jaringan infrastruktur terdekat (ESS) atau jaringan ad-hoc (IBSS) lainnya. Ini memungkinkan adaptor jaringan nirkabel untuk menemukan jaringan lain dan mungkin terhubung ke jaringan dengan sinyal yang lebih kuat. Sebagian besar driver jaringan 802.11 saat ini memindai semua saluran yang tersedia sebagai seri sekaligus. Ketika driver jaringan 802.11 memindai jaringan lain dan mendengarkan di saluran lain, driver jaringan tidak dapat menerima paket untuk aplikasi. Waktu yang dihabiskan untuk pemindaian untuk jaringan lain dapat memperkenalkan celah yang nyata (100 milidetik atau lebih) ketika aplikasi VoIP tidak akan dapat menerima aliran audio. Proses pemindaian ini lebih lama untuk adaptor jaringan 802.11 yang merupakan band ganda (2,4GHz dan 5GHz) karena bahkan lebih banyak saluran dipindai. Ini dapat mengakibatkan audio dianggap gagap.

Ketika fungsi SetSocketMediaStreamingMode dipanggil dengan parameter nilai yang diatur ke TRUE dan soket akan ditransfer melalui adaptor jaringan nirkabel 802.11, sistem akan memberi tahu driver jaringan nirkabel untuk berhenti memindai jaringan lain. Ini menghilangkan gagap oleh VoIP dan aplikasi audio serupa ketika digunakan lebih dari 802.11 jaringan nirkabel, tetapi juga mempengaruhi aplikasi apa pun yang berjalan di komputer atau perangkat lokal.

Ada kasus di mana menonaktifkan pemindaian dapat menyebabkan masalah. Ketika pemindaian dinonaktifkan, komputer lokal tetap terhubung ke jaringan yang sama bahkan jika sinyal menjadi lebih lemah dan lebih lemah saat pengguna menjauh dari jaringan.

VoIP atau aplikasi serupa harus menutup semua soket latensi rendah untuk memulihkan mode streaming media driver jaringan nirkabel 802.11. Ini akan memfungsikan kembali pemindaian untuk jaringan nirkabel lainnya.

Fungsi SetSocketMediaStreamingMode tidak berpengaruh jika soket tidak akan mengirim atau menerima paket melalui adaptor nirkabel 802.11.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	socketapi.h
Pustaka	Windows.Networking.lib
DLL	Windows.Networking.dll

Lihat juga

Menambahkan dukungan untuk jaringan

Windows.Networking.BackgroundTransfer

Windows.Networking.Sockets