Partager via


constantes LINECONNECTEDMODE_

Les constantes d’indicateur de bits LINECONNECTEDMODE_ décrivent différents sous-états d’un appel connecté. Un mode est disponible en tant que status d’appel à l’application après la transition de l’état de l’appel vers connecté, et dans le message LINE_CALLSTATE indiquant que l’appel est en LINECALLSTATE_CONNECTED. Ces valeurs sont utilisées lorsque l’appel se trouve sur une adresse partagée (pontée) avec d’autres stations (pour plus d’informations, voir constantes LINEADDRESSSHARING_), principalement des systèmes de clés électroniques. Les LINECONNECTEDMODE_constants ont les valeurs suivantes :

LINECONNECTEDMODE_ACTIVE

Indique que l’appel est connecté à la station actuelle (la station actuelle est un participant à l’appel). Si le mode d’état d’appel est égal à 0 (zéro), l’application doit supposer que la valeur est « active » (ce qui correspondrait à la situation sur une adresse non pontée). Le mode peut basculer entre ACTIVE et INACTIF pendant un appel si l’utilisateur rejoint et quitte l’appel via une action manuelle. Dans une telle situation, une opération lineDrop ou lineHold peut ne pas réellement supprimer l’appel ou le mettre en attente, car la status d’autres stations de l’appel peut régir (par exemple, une tentative de « conservation » d’un appel lorsque d’autres stations participent n’est pas possible). Au lieu de cela, l’appel peut être remplacé par le mode INACTIF s’il reste CONNECTÉ à d’autres stations.

LINECONNECTEDMODE_ACTIVEHELD

Indique que la station est un participant actif à l’appel, mais que la partie distante a mis l’appel en attente (l’autre partie considère que l’appel est dans l’état d’attente). Normalement, ces informations sont disponibles uniquement lorsque les deux points de terminaison de l’appel appartiennent au même domaine de basculement. Cet indicateur est exposé uniquement aux applications qui négocient une version TAPI 2.0 ou ultérieure. (TAPI versions 2.0 et ultérieures)

LINECONNECTEDMODE_CONFIRMED

Indique que le fournisseur de services a reçu une notification positive indiquant que l’appel est entré dans l’état connecté (par exemple, par le biais de la supervision des réponses ou de mécanismes similaires). Cet indicateur est exposé uniquement aux applications qui négocient une version TAPI 2.0 ou ultérieure. (TAPI versions 2.0 et ultérieures)

LINECONNECTEDMODE_INACTIVE

Indique que l’appel est actif dans une ou plusieurs autres stations, mais que la station actuelle n’est pas un participant à l’appel. Si le mode d’état d’appel est ZÉRO, l’application doit supposer que la valeur est « active » (ce qui serait la situation sur une adresse non pontée). Un appel à l’état INACTIF peut être joint à l’aide de lineAnswer. De nombreuses opérations valides dans les appels à l’état CONNECTÉ peuvent être impossibles en mode INACTIF, telles que la surveillance des tonalités et des chiffres, car la station ne participe pas réellement à l’appel ; l’analyse est généralement suspendue (bien qu’elle ne soit pas annulée) pendant que l’appel est en mode INACTIF.

LINECONNECTEDMODE_INACTIVEHELD

Indique que la station n’est pas un participant actif à l’appel et que la partie distante a mis l’appel en attente. Cet indicateur est exposé uniquement aux applications qui négocient une version TAPI 2.0 ou ultérieure. (TAPI versions 2.0 et ultérieures)

Notes

Non extensible. Les 32 bits sont réservés.

Pour la compatibilité descendante, il incombe au fournisseur de services d’examiner la version négociée de l’API sur la ligne et de ne pas utiliser ces valeurs LINECONNECTEDMODE_ qui ne sont pas prises en charge sur la version négociée. Les applications qui ne connaissent pas LINECONNECTEDMODE_ supposent probablement qu’un appel en LINECALLSTATE_CONNECTED est en LINECONNECTEDMODE_ACTIVE.

Les valeurs LINECONNECTEDMODE_ACTIVE et LINECONNECTEDMODE_INACTIVE sont utilisées lorsque l’appel se trouve sur une adresse partagée avec d’autres stations (pontée ; voir constantes LINEADDRESSSHARING_), principalement des systèmes de clés électroniques. Si le mode d’état de l’appel connecté est « actif », cela signifie que l’appel est connecté à la station actuelle (la station actuelle est un participant à l’appel). Si le mode d’état d’appel est « inactif », l’appel est actif sur une ou plusieurs autres stations, mais la station actuelle n’est pas un participant à l’appel. Si le mode d’état d’appel est ZÉRO, l’application doit supposer que la valeur est « active » (ce qui serait la situation sur une adresse non pontée). Le mode peut basculer entre ACTIVE et INACTIF pendant un appel si l’utilisateur rejoint et quitte l’appel via une action manuelle.

Dans une telle situation, une opération lineDrop ou lineHold peut ne pas réellement abandonner l’appel ou le mettre en attente, car la status d’autres stations de l’appel peut régir (par exemple, une tentative de « conservation » d’un appel lorsque d’autres stations participent ne sera pas possible). Au lieu de cela, l’appel peut simplement être remplacé par le mode INACTIF s’il reste connecté à d’autres stations. Un appel à l’état INACTIF peut être joint à l’aide de lineAnswer.

De nombreuses opérations valides dans les appels à l’état connecté peuvent être impossibles en mode INACTIF, telles que la surveillance des tonalités et des chiffres, car la station ne participe pas réellement à l’appel ; l’analyse est généralement suspendue (bien qu’elle ne soit pas annulée) pendant que l’appel est en mode INACTIF.

Spécifications

Condition requise Valeur
Version TAPI
Nécessite TAPI 2.0 ou version ultérieure
En-tête
Tapi.h

Voir aussi

lineAnswer

lineDrop

lineHold