Función SetSocketMediaStreamingMode (socketapi.h)

La función SetSocketMediaStreamingMode indica si la red se va a usar para transferir medios de streaming que requieren calidad de servicio.

Sintaxis

HRESULT SetSocketMediaStreamingMode(
  BOOL value
);

Parámetros

value

Indica si la red se va a usar para transferir medios de streaming que requieren calidad de servicio. Esto garantiza que los sockets abiertos como baja latencia obtendrán la calidad correcta de servicio en más de 802.11 redes inalámbricas.

Valor devuelto

Si no se produce ningún error, SetSocketMediaStreamingMode devuelve S_OK. De lo contrario, se devuelve un código de error como HRESULT.

Comentarios

La función SetSocketMediaStreamingMode se usa para indicar si la red se va a usar para transferir medios de streaming que requieren calidad de servicio. Normalmente, esta función se usa en voice over IP (VoIP) o en aplicaciones similares que requieren una calidad de servicio coherente. Las aplicaciones de la Tienda Windows o las aplicaciones de escritorio pueden usar la función SetSocketMediaStreamingMode .

Puede haber problemas de calidad de servicio para el streaming multimedia cuando se usa a través de una red inalámbrica 802.11. El controlador de red 802.11 buscará periódicamente otras redes de infraestructura cercanas (ESS) o redes ad hoc (IBSS). Esto permite al adaptador de red inalámbrica encontrar otras redes y posiblemente conectadas a una red con una señal más fuerte. La mayoría de los controladores de red 802.11 actuales examinan todos los canales disponibles como una serie a la vez. Cuando el controlador de red 802.11 busca otras redes y escucha en otros canales, no puede recibir paquetes para la aplicación. El tiempo invertido en el examen de otras redes puede introducir una brecha notable (100 milisegundos o más) cuando una aplicación VoIP no podría recibir la secuencia de audio. Este proceso de escaneo es más largo para adaptadores de red de 802,11 que son de doble banda (2,4 GHz y 5 GHz), ya que se examinan aún más canales. Esto puede dar lugar a que el audio se perciba como tartamudeo.

Cuando se llama a la función SetSocketMediaStreamingMode con el parámetro value establecido en TRUE y el socket se transferirá a través de un adaptador de red inalámbrica 802.11, el sistema notificará al controlador de red inalámbrica que detenga el examen de otras redes. Esto elimina la agitación por VoIP y aplicaciones de audio similares cuando se usan más de 802.11 redes inalámbricas, pero también afecta a las aplicaciones que se ejecutan en el equipo o dispositivo local.

Hay casos en los que la desactivación de exámenes puede causar problemas. Cuando los exámenes están deshabilitados, el equipo local permanece conectado a la misma red incluso si la señal se vuelve más débil y débil a medida que el usuario se aleja de la red.

Una aplicación VoIP o similar debe cerrar todos los sockets de baja latencia para restaurar el modo de streaming multimedia del controlador de red inalámbrica 802.11. Esto volverá a habilitar el examen de otras redes inalámbricas.

La función SetSocketMediaStreamingMode no tiene ningún efecto si el socket no va a enviar ni recibir paquetes a través de un adaptador inalámbrico 802.11.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	socketapi.h
Library	Windows.Networking.lib
Archivo DLL	Windows.Networking.dll

Consulte también

Adición de compatibilidad con redes

Windows.Networking.BackgroundTransfer

Windows.Networking.Sockets