SetSocketMediaStreamingMode 函式 (socketapi.h)
SetSocketMediaStreamingMode 函式指出是否要使用網路來傳輸需要服務品質的串流媒體。
語法
HRESULT SetSocketMediaStreamingMode(
BOOL value
);
參數
value
指出網路是否要用於傳輸需要服務品質的串流媒體。 這可確保以低延遲方式開啟的套接字會透過802.11無線網路取得正確的服務品質。
傳回值
如果沒有發生錯誤， SetSocketMediaStreamingMode 會傳回S_OK。 否則，錯誤碼會以 HRESULT 的形式傳回。
備註
SetSocketMediaStreamingMode 函式可用來指出網路是否要用於傳輸需要服務品質的串流媒體。 此函式通常由需要一致服務質量的語音 over IP (VoIP) 或類似的應用程式使用。 Windows 市集應用程式或傳統型應用程式可以使用 SetSocketMediaStreamingMode 函式。
透過 802.11 無線網路使用媒體串流時，可能會有服務質量問題。 802.11 網路驅動程式會定期掃描其他鄰近基礎結構網路， (ESS) 或臨機操作網路， (IBSS) 。 這可讓無線網路適配卡尋找其他網路，而且可能連線到具有更強訊號的網路。 最新的 802.11 網路驅動程式會一次掃描所有可用的通道作為一系列。 當 802.11 網路驅動程式掃描其他網路並接聽其他通道時，它無法接收應用程式的封包。 掃描其他網路所花費的時間可能會造成明顯差距， (100 毫秒以上) 當 VoIP 應用程式無法接收音訊串流時。 此掃描程式對於雙頻 (2.4GHz 和 5GHz) 的 802.11 網路適配器而言較長，因為會掃描更多通道。 這可能會導致音訊被視為雜亂。
呼叫 SetSocketMediaStreamingMode 函式時， 值 參數設定為 TRUE ，套接字將會透過 802.11 無線網路適配卡傳輸，系統會通知無線網路驅動程式停止掃描其他網路。 這可在超過 802.11 無線網路使用時，排除 VoIP 和類似的音訊應用程式雜亂，但也會影響在本機電腦或裝置上執行的任何應用程式。
在某些情況下，關閉掃描可能會導致問題。 停用掃描時，即使使用者離開網路，本機計算機仍會保持連線到相同的網路。
VoIP 或類似的應用程式應該關閉所有低延遲套接字，以還原 802.11 無線網路驅動程式的媒體串流模式。 這會重新啟用其他無線網路的掃描。
如果套接字不會透過 802.11 無線適配卡傳送或接收封包， SetSocketMediaStreamingMode 函式就不會有任何作用。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | socketapi.h |
| 程式庫 | Windows.Networking.lib |
| Dll | Windows.Networking.dll |