ITConnection::SetBandwidthInfo-Methode

[ Steuerelemente und Schnittstellen für Rendezvous-IP-Telefonkonferenzen sind in Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems nicht 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 vorhanden, um den Vorgang auszuführen.
E_FAIL
Unbekannter Fehler.
E_NOTIMPL
Diese Methode ist noch nicht implementiert.

Bemerkungen

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

Referenz: RFC 2327.

Der Bandbreitenmodifizierer ist normalerweise entweder CT oder AS:

CT Konferenz Gesamt: Eine implizite maximale Bandbreite ist mit jeder Gültigkeitsdauer (TTL) in Mbone oder innerhalb einer bestimmten Multicast-Verwaltungsbereichsregion verknüpft (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 vom Bereich impliziten Bandbreite unterscheidet, wird ein "b=CT:..." Für die Sitzung sollte eine Zeile bereitgestellt werden, die die vorgeschlagene Obergrenze für die verwendete Bandbreite angibt. Der Primäre Zweck ist es, eine ungefähre Vorstellung davon zu vermitteln, ob zwei oder mehr Konferenzen gleichzeitig vorhanden sein können.

AS Application-Specific Maximum: Die Bandbreite wird als anwendungsspezifisch interpretiert, d. h. das Konzept der maximalen Bandbreite der Anwendung. Normalerweise fällt dies mit dem zusammen, was im Steuerelement "maximale Bandbreite" der Anwendung festgelegt wird, falls zutreffend.

Beachten Sie, dass CT eine Gesamtbandbreitenzahl für alle Medien an allen Standorten angibt. AS gibt eine Bandbreitenzahl für ein einzelnes Medium an einem einzelnen Standort an, obwohl viele Websites gleichzeitig gesendet werden können.

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

Anforderungen

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

Siehe auch

ITConnection