MÉTODO ITConnection::SetBandwidthInfo

[ Los controles e interfaces de conferencia de telefonía IP de Rendezvous no están disponibles para su uso en Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. La API de cliente RTC proporciona una funcionalidad similar.]

El método SetBandwidthInfo establece la información de ancho de banda.

Sintaxis

HRESULT SetBandwidthInfo(
  [in] BSTR   pModifier,
  [in] DOUBLE Bandwidth
);

Parámetros

pModifier [in]

Puntero a un BSTR que indica el ámbito del ancho de banda que se va a establecer. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Ancho de banda [in]

Ancho de banda.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	El método se realizó correctamente.
E_INVALIDARG	El parámetro pModifier o Bandwidth no es válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
E_FAIL	Error no especificado.
E_NOTIMPL	Este método aún no se ha implementado.

Comentarios

La aplicación debe usar SysAllocString para asignar memoria para el parámetro pModifier y usar SysFreeString para liberar la memoria cuando la variable ya no sea necesaria.

Referencia: RFC 2327.

Normalmente, el modificador de ancho de banda será CT o AS:

Total de conferencia de CT: Un ancho de banda máximo implícito se asocia con cada vez que se vive (TTL) en Mbone o dentro de una región de ámbito administrativo de multidifusión determinada (el ancho de banda de Mbone frente a los límites de TTL se proporcionan en las preguntas más frecuentes sobre MBone). Si el ancho de banda de una sesión o un medio de una sesión es diferente del ancho de banda implícito del ámbito, un "b=CT:..." Se debe proporcionar la línea para la sesión, lo que proporciona el límite superior propuesto al ancho de banda utilizado. El objetivo principal de esto es dar una idea aproximada sobre si dos o más conferencias pueden coexistir simultáneamente.

AS Application-Specific Máximo: El ancho de banda se interpreta como específico de la aplicación, es decir, será el concepto de ancho de banda máximo de la aplicación. Normalmente, esto coincidirá con lo que se establece en el control de "ancho de banda máximo" de la aplicación, si procede.

Tenga en cuenta que CT proporciona una cifra de ancho de banda total para todos los medios en todos los sitios. AS proporciona una cifra de ancho de banda para un único medio en un único sitio, aunque puede haber muchos sitios que se envían simultáneamente.

Mecanismo de extensión: Los escritores de herramientas pueden definir modificadores de ancho de banda experimental mediante el prefijo de sus modificadores con "X-".

Requisitos

Requisito	Value
Versión de TAPI	Requiere TAPI 3.0 o posterior
Encabezado	Sdpblb.h
Biblioteca	Uuid.lib
Archivo DLL	Sdpblb.dll

Consulte también

ITConnection