fonction lineSetNumRings (tapi.h)

Article
03/04/2024

La fonction lineSetNumRings définit le nombre d’anneaux qui doivent se produire avant qu’un appel entrant soit répondu. Cette fonction peut être utilisée pour implémenter une fonction de type économiseur de péage. Il permet à plusieurs applications indépendantes d’inscrire chacune le nombre d’anneaux. La ligne de fonctionGetNumRings retourne le nombre minimal d’anneaux demandés. Il peut être utilisé par l’application qui répond aux appels entrants pour déterminer le nombre d’anneaux qu’elle doit attendre avant de répondre à l’appel.

Syntaxe

LONG lineSetNumRings(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwNumRings
);

Paramètres

hLine

Gérez l’appareil de ligne ouverte.

dwAddressID

Adresse sur l’appareil de ligne. Un identificateur d’adresse est associé de façon permanente à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation.

dwNumRings

Le nombre d’anneaux avant un appel doit être répondu afin d’honorer les demandes d’économie de péage de toutes les applications.

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Remarques

Les fonctions lineGetNumRings et lineSetNumRings , lorsqu’elles sont utilisées conjointement, fournissent un mécanisme pour prendre en charge l’implémentation de fonctionnalités d’économie de péage dans plusieurs applications indépendantes. Si aucune application n’appelle lineSetNumRings, lineGetNumRings retourne 0xFFFFFFFF.

Une application qui est le propriétaire d’un appel dans l’état de l’offre et qui a reçu un LINE_LINEDEVSTATE message de sonnerie doit attendre un nombre d’anneaux égal au nombre retourné par lineGetNumRings avant de répondre à l’appel afin de respecter les paramètres d’économie de péage dans toutes les applications. Un message de sonnerie LINE_LINEDEVSTATE distinct est envoyé à l’application pour chaque cycle d’anneau. L’application doit donc compter ces messages. Si cet appel se déconnecte avant de recevoir une réponse et qu’un autre appel arrive peu de temps après, le message LINE_CALLSTATE doit permettre à l’application de déterminer que la sonnerie est liée au deuxième appel.

Si la classification des appels est effectuée par TAPI en répondant aux appels entrants de type multimédia inconnu et en filtrant le flux multimédia, TAPI respecte également ce numéro.

Note Cette opération est purement informative et n’affecte pas l’état des appels sur l’appareil de ligne.