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 |
|---|---|
|
Methode war erfolgreich. |
|
Der Parameter pModifier oder Bandwidth ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher zum Ausführen des Vorgangs vorhanden. |
|
Unbekannter Fehler. |
|
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 |
|
| Bibliothek |
|
| DLL |
|