ITConnection::SetBandwidthInfo, méthode
[ Les contrôles et interfaces de conférence de téléphonie IP rendez-vous ne sont pas disponibles pour une utilisation dans Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. L’API cliente RTC fournit des fonctionnalités similaires.]
La méthode SetBandwidthInfo définit les informations de bande passante.
Syntaxe
HRESULT SetBandwidthInfo(
[in] BSTR pModifier,
[in] DOUBLE Bandwidth
);
Paramètres
-
pModifier [in]
-
Pointeur vers un BSTR indiquant l’étendue de la bande passante définie. Pour plus d'informations, consultez la section Notes qui suit.
-
Bande passante [in]
-
à la bande passante ;
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Signification |
|---|---|
|
La méthode a réussi. |
|
Le paramètre pModifier ou Bande passante n’est pas valide. |
|
La mémoire est insuffisante pour effectuer l’opération. |
|
Erreur non spécifiée. |
|
Cette méthode n'est pas encore implémentée. |
Notes
L’application doit utiliser SysAllocString pour allouer de la mémoire pour le paramètre pModifier et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.
Référence : RFC 2327.
Le modificateur de bande passante est normalement CT ou AS :
Total de la conférence CT : Une bande passante maximale implicite est associée à chaque durée de vie (TTL) sur le Mbone ou dans une région d’étendue administrative de multidiffusion particulière (les limites de bande passante Mbone par rapport à la durée de vie sont indiquées dans le FAQ MBone). Si la bande passante d’une session ou d’un média dans une session est différente de la bande passante implicite de l’étendue, un « b=CT:... » la ligne doit être fournie pour la session en indiquant la limite supérieure proposée pour la bande passante utilisée. L’objectif principal de cette opération est de donner une idée approximative de la possibilité de coexister simultanément entre deux conférences ou plus.
AS Application-Specific Maximum : La bande passante est interprétée comme spécifique à l’application, c’est-à-dire qu’elle sera le concept de bande passante maximale de l’application. Normalement, cela coïncide avec ce qui est défini sur le contrôle « bande passante maximale » de l’application, le cas échéant.
Notez que CT donne une valeur de bande passante totale pour tous les médias sur tous les sites. AS donne une valeur de bande passante pour un seul média sur un seul site, même s’il peut y avoir de nombreux sites qui envoient simultanément.
Mécanisme d’extension : Les enregistreurs d’outils peuvent définir des modificateurs de bande passante expérimentaux en préfixant leurs modificateurs par « X- ».
Spécifications
| Condition requise | Valeur |
|---|---|
| Version TAPI |
Nécessite TAPI 3.0 ou version ultérieure |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|