lineGetNumRings, fonction (tapi.h)

La fonction lineGetNumRings détermine le nombre d’anneaux qu’un appel entrant sur l’adresse donnée doit sonner avant de répondre à l’appel.

Syntaxe

LONG lineGetNumRings(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPDWORD lpdwNumRings
);

Paramètres

hLine

Gérez l’appareil en ligne ouverte.

dwAddressID

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

lpdwNumRings

Nombre d’anneaux qui correspond au minimum à toutes les requêtes lineSetNumRing s actuelles.

Valeur de retour

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

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

Remarques

Les fonctions lineGetNumRings et lineSetNumRings, lorsqu’elles sont utilisées en combinaison, fournissent un mécanisme permettant de prendre en charge l’implémentation des fonctionnalités d’économiseur de péage sur plusieurs applications indépendantes.

Une application qui reçoit un handle pour un appel dans l'offre état et un message LINE_LINEDEVSTATEsonnant doit attendre un nombre d’anneaux égal au nombre retourné par lineGetNumRings avant de répondre à l’appel afin d’honorer les paramètres de l’économiseur de péage sur toutes les applications. La fonction lineGetNumRings retourne le nombre minimal d’anneaux de toutes les applications spécifiés par lineSetNumRings. Étant donné que ce nombre peut varier dynamiquement, une application doit appeler lineGetNumRings chaque fois qu’elle a la possibilité de répondre à un appel. Si aucune application n’a appelé lineSetNumRings, le nombre d’anneaux retournés est 0xFFFFFFFF. Un message LINE_LINEDEVSTATE distinct est envoyé à l’application pour chaque cycle d’anneau.

Si la classification des appels est effectuée par TAPI pour répondre à tous les appels en mode multimédia inconnu et filtrer le flux multimédia, TAPI respecte également ce nombre.

Exigences

Voir aussi

Informations de référence sur les services de téléphonie de base

LINE_LINEDEVSTATE

vue d’ensemble des informations de référence sur TAPI 2.2

lineSetNumRings