mensaje de LINE_APPNEWCALL
El mensaje LINE_APPNEWCALL TAPI se envía para informar a una aplicación cuando se ha creado de forma espontánea un nuevo identificador de llamada en su nombre (distinto de a través de una llamada API desde la aplicación, en cuyo caso el identificador se habría devuelto a través de un parámetro de puntero pasado a la función).
Parámetros
-
hDevice
-
Identificador de la aplicación para el dispositivo de línea en el que se ha creado la llamada.
-
dwCallbackInstance
-
La instancia de devolución de llamada proporcionada al abrir la línea de la llamada.
-
dwParam1
-
Identificador de la dirección en la línea en la que aparece la llamada. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.
-
dwParam2
-
Identificador de la aplicación para la nueva llamada.
-
dwParam3
-
Privilegios de las aplicaciones para la nueva llamada (LINECALLPRIVILEGE_OWNER o LINECALLPRIVILEGE_MONITOR).
Valor devuelto
No de devuelve ningún valor.
Observaciones
Las aplicaciones compatibles con TAPI versión 2.0 o posterior se envían un mensaje de LINE_APPNEWCALL cada vez que la aplicación recibe de forma espontánea un identificador a una nueva llamada. Dado que el mensaje incluye los parámetros hLine y dwAddressID en los que existe la llamada, la aplicación puede crear fácilmente un nuevo objeto de llamada en el contexto correcto. El mensaje LINE_APPNEWCALL siempre va seguido inmediatamente de un mensaje de LINE_CALLSTATE que indica el estado inicial de la llamada.
Las aplicaciones anteriores (que negociaban una versión de API anterior a la 2.0) solo se envían un mensaje de LINE_CALLSTATE , como se documenta en versiones anteriores de la API. Estas aplicaciones crearían un nuevo objeto de llamada al recibir un mensaje de LINE_CALLSTATE que tiene dwParam3 establecido en un valor distinto de cero y que contiene un identificador de llamada no conocido actualmente por la aplicación. Las desventajas son que (a) la aplicación debe llamar a lineGetCallInfo para determinar los parámetros hLine y dwAddressID asociados a la llamada; (b) la aplicación debe examinar todos los identificadores de llamadas conocidos para determinar que la llamada es una llamada nueva; y (c) es posible, en determinadas condiciones, que la aplicación piense que recibe un nuevo identificador de llamada cuando, en realidad, acaba de desasignar su identificador a la llamada (por ejemplo, la aplicación acaba de desasignar un identificador de llamada, pero un mensaje de LINE_CALLSTATE que proporciona la propiedad de la aplicación de la llamada debido a una lineHandoff de otra aplicación ya estaba en la cola de mensajes TAPI de la aplicación).
Requisitos
| Requisito | Value |
|---|---|
| Versión de TAPI |
Requiere TAPI 2.0 o posterior |
| Encabezado |
|