Partager via


LINE_CALLINFO message

Le message tapi LINE_CALLINFO est envoyé lorsque les informations d’appel relatives à l’appel spécifié ont changé. L’application peut appeler lineGetCallInfo pour déterminer les informations d’appel actuelles.

            

Paramètres

hDevice

Handle de l’appel.

dwCallbackInstance

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

dwParam1

Élément d’informations sur l’appel qui a changé. Il peut s’agir d’une ou plusieurs constantes LINECALLINFOSTATE_.

dwParam2

Inutilisé.

dwParam3

Inutilisé.

Valeur retournée

Pas de valeur de retour.

Notes

Un message LINE_CALLINFO avec une indication NumOwnersIncr, NumOwnersDecr et/ou NumMonitorsChanged est envoyé aux applications qui disposent déjà d’un handle pour l’appel. Cela peut être le résultat d’une autre application qui change la propriété ou la surveillance d’un appel avec lineOpen, lineClose, lineShutdown, lineSetCallPrivilege, lineGetNewCalls et lineGetConfRelatedCalls.

Ces LINE_CALLINFO messages ne sont pas envoyés lorsqu’une notification d’un nouvel appel est fournie dans un message de LINE_CALLSTATE , car les informations d’appel reflètent déjà le nombre correct de propriétaires et de moniteurs au moment de l’envoi des messages LINE_CALLSTATE. LINE_CALLINFO messages sont également supprimés dans le cas où un appel est proposé par TAPI aux moniteurs via le mécanisme de LINECALLSTATE_UNKNOWN.

Notes

L’application qui provoque une modification du nombre de propriétaires ou de moniteurs (par exemple, en appelant lineDeallocateCall ou lineSetCallPrivilege) ne reçoit pas elle-même un message indiquant que la modification a été effectuée.

Aucun LINE_CALLINFO messages n’est envoyé pour un appel une fois que l’appel est entré dans l’état inactif . Plus précisément, les changements dans le nombre de propriétaires et de moniteurs ne sont pas signalés, car les applications libèrent leurs handles pour l’appel inactif.

Spécifications

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

Voir aussi

lineClose

lineDeallocateCall

lineGetCallInfo

lineGetConfRelatedCalls

lineGetNewCalls

lineOpen

lineSetCallPrivilege

lineShutdown