Método ITConnection::SetBandwidthInfo

[ Controles e interfaces de conferência de telefonia ip de encontro não estão disponíveis para uso no Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. A API do Cliente RTC fornece funcionalidade semelhante.]

O método SetBandwidthInfo define as informações de largura de banda.

Sintaxe

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

Parâmetros

pModifier [in]

Ponteiro para um BSTR que indica o escopo da largura de banda que está sendo definida. Para obter mais informações, consulte a seção Comentários a seguir.

Largura de banda [in]

Banda.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
E_INVALIDARG	O parâmetro pModifier ou Bandwidth não é válido.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.
E_FAIL	Erro não especificado.
E_NOTIMPL	Este método ainda não foi implementado.

Comentários

O aplicativo deve usar SysAllocString para alocar memória para o parâmetro pModifier e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

Referência: RFC 2327.

O modificador de largura de banda normalmente será CT ou AS:

Ct Conference Total: Uma largura de banda máxima implícita é associada a cada TTL ( vida útil ) no Mbone ou em uma região de escopo administrativo multicast específica (os limites de largura de banda Mbone versus TTL são fornecidos nas perguntas frequentes do MBone). Se a largura de banda de uma sessão ou mídia em uma sessão for diferente da largura de banda implícita do escopo, um 'b=CT:...' A linha deve ser fornecida para a sessão, dando o limite superior proposto à largura de banda usada. A principal finalidade disso é dar uma ideia aproximada sobre se duas ou mais conferências podem coexistir simultaneamente.

AS Application-Specific Maximum: A largura de banda é interpretada como específica do aplicativo, ou seja, será o conceito do aplicativo de largura de banda máxima. Normalmente, isso coincidirá com o que está definido no controle de "largura de banda máxima" do aplicativo, se aplicável.

Observe que a CT fornece uma figura de largura de banda total para toda a mídia em todos os sites. O AS fornece uma figura de largura de banda para uma única mídia em um único site, embora possa haver muitos sites enviando simultaneamente.

Mecanismo de extensão: Os gravadores de ferramentas podem definir modificadores experimentais de largura de banda prefixando seus modificadores com "X-".

Requisitos

Requisito	Valor
Versão do TAPI	Requer TAPI 3.0 ou posterior
Cabeçalho	Sdpblb.h
Biblioteca	Uuid.lib
DLL	Sdpblb.dll

Confira também

ITConnection