LINE_CALLSTATE message

Le message de LINE_CALLSTATE TAPI est envoyé lorsque le status de l’appel spécifié a changé. En règle générale, plusieurs messages de ce type sont reçus pendant la durée de vie d’un appel. Les applications sont averties des nouveaux appels entrants avec ce message ; le nouvel appel est dans l’état de l’offre . L’application peut utiliser lineGetCallStatus pour récupérer des informations plus détaillées sur la status actuelle de l’appel.

Paramètres

hDevice

Handle de l’appel.

dwCallbackInstance

Le rappel instance fourni lors de l’ouverture de la ligne de l’appel.

dwParam1

Nouvel état d’appel. Ce paramètre doit être une seule des constantes LINECALLSTATE_ suivantes.

dwParam1	Signification
LINECALLSTATE_BUSY	dwParam2 contient des détails sur le mode occupé. Ce paramètre utilise l’une des constantes LINEBUSYMODE_.
LINECALLSTATE_CONNECTED	dwParam2 contient des détails sur le mode connecté. Ce paramètre utilise l’une des constantes LINECONNECTEDMODE_.
LINECALLSTATE_DIALTONE	dwParam2 contient des détails sur le mode de tonalité. Ce paramètre utilise l’une des constantes LINEDIALTONEMODE_.
LINECALLSTATE_OFFERING	dwParam2 contient des détails sur le mode connecté. Ce paramètre utilise l’une des constantes LINEOFFERINGMODE_.
LINECALLSTATE_SPECIALINFO	dwParam2 contient les détails du mode d’informations spécial. Ce paramètre utilise l’une des constantes LINESPECIALINFO_.
LINECALLSTATE_DISCONNECTED	dwParam2 contient des détails sur le mode de déconnexion. Ce paramètre utilise l’une des constantes LINEDISCONNECTMODE_.

dwParam2

Informations dépendantes de l’état des appels. Consultez dwParam1.

Notes

Dans les circonstances où une réponse différée est appropriée, utilisez LINEDISCONNECTMODE_TEMPFAILURE. Lorsqu’une réponse de liste de blocage est appropriée, utilisez LINEDISCONNECT_BLOCKED. Pour plus d’informations, consultez constantes LINEDISCONNECTMODE_.

Si dwParam1 est LINECALLSTATE_CONFERENCED, dwParam2 contient le paramètre hConfCall de l’appel parent de la conférence dont l’objet hCall est membre. Si l’appel spécifié dans dwParam2 n’a pas été précédemment considéré par l’application comme une téléconférence parente (hConfCall), l’application doit le faire à la suite de ce message. Si l’application n’a pas de handle pour l’appel parent de la conférence (car elle a précédemment appelé lineDeallocateCall sur ce handle), dwParam2 est défini sur NULL.

dwParam3

Si la valeur est zéro, ce paramètre indique qu’il n’y a pas eu de modification dans les privilèges de l’application pour l’appel.

Si elle n’est pas nulle, elle spécifie le privilège de l’application pour l’appel. Cela se produit dans les situations suivantes : (1) La première fois que l’application reçoit un handle pour cet appel ; (2) Lorsque l’application est la cible d’un transfert d’appel (même si l’application était déjà propriétaire de l’appel). Ce paramètre utilise l’une des constantes LINECALLPRIVILEGE_ suivantes.

Valeur retournée

Pas de valeur de retour.

Notes

Ce message est envoyé à toute application qui a un handle pour l’appel. Le message LINE_CALLSTATE avertit également les applications qui surveillent les appels sur une ligne de l’existence et de l’état des appels sortants établis par d’autres applications ou manuellement par l’utilisateur (par exemple, sur un appareil téléphonique attaché). L’état d’appel de ces appels reflète l’état réel de l’appel, qui n’est pas proposé. En examinant l’état de l’appel, l’application peut déterminer s’il s’agit d’un appel entrant auquel il faut répondre ou non.

Un message LINE_CALLSTATE avec un état d’appel inconnu peut être envoyé à une application de surveillance en raison d’une réussite de lineMakeCall, lineForward, lineUnpark, lineSetupTransfer, linePickup, lineSetupConference ou linePrepareAddToConference qui a été demandée par une autre application. En même temps que l’application demandeure reçoit un LINE_REPLY (réussite) pour l’opération demandée, toutes les applications de surveillance sur la ligne reçoivent le message LINE_CALLSTATE (inconnu). Un message LINE_CALLSTATE indiquant l’état « réel » de l’appel nouvellement généré est envoyé (à l’aide des informations fournies par le fournisseur de services) aux applications de demande et de surveillance peu après.

Un message LINE_CALLSTATE (inconnu) est envoyé aux applications de supervision uniquement si lineCompleteTransfer entraîne la résolution des appels en une conférence triple.

Pour la compatibilité descendante, les applications plus anciennes n’attendent pas de valeur particulière dans dwParam2 d’un message LINECALLSTATE_CONFERENCED. TAPI transmet donc l’appel parent hConfCall dans dwParam2 , quelle que soit la version de l’API de l’application recevant le message. Dans le cas d’une téléconférence lancée par le fournisseur de services, l’ancienne application ne sait pas que l’appel parent est devenu une téléconférence, sauf s’il s’agit d’examiner spontanément d’autres informations (par exemple, ligne d’appelGetConfRelatedCalls).

Impossible de désactiver ce message.

Spécifications

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

Voir aussi

LINE_REPLY

lineCompleteTransfer

lineDeallocateCall

LINEDIALPARAMS

lineForward

lineGenerateDigits

lineGetCallStatus

lineGetConfRelatedCalls

lineMakeCall

linePickup

linePrepareAddToConference

lineSetupTransfer

lineUnpark