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 |
---|---|
|
Methode war erfolgreich. |
|
Der Parameter pModifier oder Bandwidth ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen. |
|
Unbekannter Fehler. |
|
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 |
|
Bibliothek |
|
DLL |
|