ITConnection::SetBandwidthInfo-Methode

[Rendezvous-IP-Telefoniekonferenz-Steuerelemente und -Schnittstellen sind nicht für die Verwendung in Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die RTC-Client-API bietet ähnliche Funktionen.]

Die SetBandwidthInfo-Methode legt die Bandbreiteninformationen fest.

Syntax

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

Parameter

pModifier [ In]

Zeiger auf einen BSTR, der den Bereich der festzulegenden Bandbreite angibt. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Bandbreite [ In]

Bandbreite.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert Bedeutung
S _ OK
Methode war erfolgreich.
E _ INVALIDARG
Der Parameter pModifier oder Bandwidth ist ungültig.
E _ OUTOFMEMORY
Es ist nicht genügend Arbeitsspeicher zum Ausführen des Vorgangs vorhanden.
E _ FAIL
Unbekannter Fehler.
E _ NOTIMPL
Diese Methode ist noch nicht implementiert.

Hinweise

Die Anwendung muss SysAllocString verwenden, um Speicher für den pModifier-Parameter zuzuordnen, und SysFreeString verwenden, um den Arbeitsspeicher freizugeben, wenn die Variable nicht mehr benötigt wird.

Referenz: RFC 2327.

Der Bandbreitenmodifizierer ist normalerweise entweder CT oder AS:

CT Conference Total: Jeder Gültigkeitsdauer (TTL) in Mbone oder innerhalb einer bestimmten Multicast-Verwaltungsbereichsregion ist eine implizite maximale Bandbreite zugeordnet (die Mbone-Bandbreiten- und TTL-Grenzwerte sind in den häufig gestellten Fragen zu MBone angegeben). Wenn sich die Bandbreite einer Sitzung oder eines Mediums in einer Sitzung von der impliziten Bandbreite des Bereichs unterscheidet, ist ` a b=CT:...' für die Sitzung sollte eine Zeile angegeben werden, die die vorgeschlagene Obergrenze für die verwendete Bandbreite angibt. Der Hauptzweck besteht darin, eine ungefähre Vorstellung davon zu geben, ob zwei oder mehr Konferenzen gleichzeitig vorhanden sein können.

AS Application-Specific Maximum: Die Bandbreite wird als anwendungsspezifisch interpretiert, d. h., sie ist das Konzept der maximalen Bandbreite der Anwendung. Normalerweise stimmt dies mit dem überein, was ggf. für die Steuerung der "maximalen Bandbreite" der Anwendung festgelegt wird.

Beachten Sie, dass ct eine Gesamtbandbreitenzahl für alle Medien an allen Standorten ergibt. AS gibt eine Bandbreitenzahl für ein einzelnes Medium an einem einzelnen Standort an, obwohl es möglicherweise viele Standorte gibt, die gleichzeitig senden.

Erweiterungsmechanismus: Toolwriter können experimentelle Bandbreitenmodifizierer definieren, indem sie ihren Modifizierern "X-" vorangestellt werden.

Anforderungen

Anforderung Wert
TAPI-Version
Erfordert TAPI 3.0 oder höher
Header
Sdpblb.h
Bibliothek
Uuid.lib
DLL
Sdpblb.dll

Weitere Informationen

ITConnection