Metodo ITConnection::SetBandwidthInfo

[ I controlli e le interfacce di telefonia IP rendezvous IP non sono disponibili per l'uso in Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. L'API client RTC offre funzionalità simili.

Il metodo SetBandwidthInfo imposta le informazioni sulla larghezza di banda.

Sintassi

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

Parametri

pModifier [in]

Puntatore a un valore BSTR che indica l'ambito della larghezza di banda impostata. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Larghezza di banda [in]

Banda.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_INVALIDARG	Il parametro pModifier o Bandwidth non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
E_FAIL	Errore non specificato.
E_NOTIMPL	Questo metodo non è ancora implementato.

Commenti

L'applicazione deve usare SysAllocString per allocare memoria per il parametro pModifier e usare SysFreeString per liberare la memoria quando la variabile non è più necessaria.

Riferimento: RFC 2327.

Il modificatore della larghezza di banda sarà normalmente CT o AS:

Totale conferenza CT: Una larghezza di banda massima implicita è associata a ogni durata (TTL) nell'mbone o all'interno di un'area specifica dell'ambito amministrativo multicast (la larghezza di banda Mbone e i limiti TTL vengono specificati nelle domande frequenti su MBone). Se la larghezza di banda di una sessione o di un supporto in una sessione è diversa dalla larghezza di banda implicita dall'ambito, un 'b=CT:...' la riga deve essere fornita per la sessione assegnando il limite superiore proposto alla larghezza di banda usata. Lo scopo principale di questo è dare un'idea approssimativa di se due o più conferenze possono coesistere simultaneamente.

AS Application-Specific Massimo: La larghezza di banda viene interpretata come specifica dell'applicazione, ovvero il concetto di larghezza di banda massima dell'applicazione. In genere ciò coinciderà con ciò che viene impostato nel controllo "larghezza di banda massima" dell'applicazione, se applicabile.

Si noti che CT fornisce una larghezza di banda totale per tutti i supporti in tutti i siti. AS fornisce una cifra di larghezza di banda per un singolo supporto in un singolo sito, anche se possono essere presenti molti siti che inviano contemporaneamente.

Meccanismo di estensione: Gli autori di strumenti possono definire modificatori di larghezza di banda sperimentali anteponendo i modificatori con "X-".

Requisiti

Requisito	Valore
Versione TAPI	Richiede TAPI 3.0 o versione successiva
Intestazione	Sdpblb.h
Libreria	Uuid.lib
DLL	Sdpblb.dll

Vedi anche

ITConnection