LINE_APPNEWCALL message
Le message tapi LINE_APPNEWCALL est envoyé pour informer une application lorsqu’un nouveau handle d’appel a été créé spontanément en son nom (autre que par le biais d’un appel d’API de l’application, auquel cas le handle aurait été retourné via un paramètre de pointeur passé à la fonction).
Paramètres
-
hDevice
-
Handle de l’application sur l’appareil de ligne sur lequel l’appel a été créé.
-
dwCallbackInstance
-
Le rappel instance fourni lors de l’ouverture de la ligne de l’appel.
-
dwParam1
-
Identificateur de l’adresse sur la ligne sur laquelle l’appel s’affiche. 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.
-
dwParam2
-
Handle de l’application pour le nouvel appel.
-
dwParam3
-
Privilège d’application pour le nouvel appel (LINECALLPRIVILEGE_OWNER ou LINECALLPRIVILEGE_MONITOR).
Valeur retournée
Pas de valeur de retour.
Notes
Les applications prenant en charge TAPI version 2.0 ou ultérieure reçoivent un message LINE_APPNEWCALL chaque fois que l’application reçoit spontanément un handle pour un nouvel appel. Étant donné que le message inclut les paramètres hLine et dwAddressID sur lesquels l’appel existe, l’application peut facilement créer un objet d’appel dans le contexte approprié. Le message LINE_APPNEWCALL est toujours immédiatement suivi d’un message LINE_CALLSTATE indiquant l’état initial de l’appel.
Les applications plus anciennes (qui ont négocié une version d’API antérieure à 2.0) ne sont envoyées qu’un message LINE_CALLSTATE , comme indiqué dans les versions précédentes de l’API. De telles applications créeraient un nouvel objet d’appel à la réception d’un message LINE_CALLSTATE dont dwParam3 est défini sur une valeur différente de zéro et contenant un handle d’appel non connu actuellement par l’application. Les inconvénients sont que (a) l’application doit appeler lineGetCallInfo pour déterminer les paramètres hLine et dwAddressID associés à l’appel ; (b) l’application doit analyser tous les handles d’appel connus pour déterminer que l’appel est un nouvel appel ; et (c) il est possible, sous certaines conditions, que l’application pense recevoir un nouveau handle d’appel alors qu’en réalité elle vient de libérer son handle vers l’appel (par exemple, l’application vient de libérer un handle d’appel, mais un message LINE_CALLSTATE donnant la propriété de l’application à l’appel en raison d’une ligneHandoff d’une autre application se trouvait déjà dans la file d’attente de messages TAPI de l’application).
Spécifications
| Condition requise | Valeur |
|---|---|
| Version TAPI |
Nécessite TAPI 2.0 ou version ultérieure |
| En-tête |
|