LINE_CALLSTATE mensaje
El mensaje de LINE_CALLSTATE TAPI se envía cuando ha cambiado el estado de la llamada especificada. Normalmente, se reciben varios mensajes de este tipo durante la duración de una llamada. Las aplicaciones reciben notificaciones de nuevas llamadas entrantes con este mensaje; la nueva llamada se encuentra en el estado de oferta . La aplicación puede usar lineGetCallStatus para recuperar información más detallada sobre el estado actual de la llamada.
Parámetros
-
hDevice
-
Identificador de la llamada.
-
dwCallbackInstance
-
La instancia de devolución de llamada proporcionada al abrir la línea de la llamada.
-
dwParam1
-
Nuevo estado de llamada. Este parámetro debe ser una y solo una de las siguientes constantes LINECALLSTATE_.
dwParam1 Significado - LINECALLSTATE_BUSY
dwParam2 contiene detalles sobre el modo ocupado. Este parámetro usa una de las constantes LINEBUSYMODE_. - LINECALLSTATE_CONNECTED
dwParam2 contiene detalles sobre el modo conectado. Este parámetro usa una de las constantes LINECONNECTEDMODE_. - LINECALLSTATE_DIALTONE
dwParam2 contiene detalles sobre el modo de tono de marcado. Este parámetro usa una de las constantes LINEDIALTONEMODE_. - LINECALLSTATE_OFFERING
dwParam2 contiene detalles sobre el modo conectado. Este parámetro usa una de las constantes LINEOFFERINGMODE_. - LINECALLSTATE_SPECIALINFO
dwParam2 contiene los detalles sobre el modo de información especial. Este parámetro usa una de las constantes LINESPECIALINFO_. - LINECALLSTATE_DISCONNECTED
dwParam2 contiene detalles sobre el modo de desconexión. Este parámetro usa una de las constantes LINEDISCONNECTMODE_. -
dwParam2
-
Información dependiente del estado de llamada. Consulte dwParam1.
Nota
En circunstancias en las que sea adecuada una respuesta diferida , use LINEDISCONNECTMODE_TEMPFAILURE. Cuando sea adecuada una respuesta en la lista de bloqueados , use LINEDISCONNECT_BLOCKED. Para obtener más información, consulte LINEDISCONNECTMODE_ Constantes.
Si dwParam1 es LINECALLSTATE_CONFERENCED, dwParam2 contiene el parámetro hConfCall de la llamada primaria de la conferencia de la que el asunto hCall es miembro. Si la aplicación no consideró previamente la llamada especificada en dwParam2 como una llamada de conferencia primaria (hConfCall), la aplicación debe hacerlo como resultado de este mensaje. Si la aplicación no tiene un identificador para la llamada primaria de la conferencia (porque anteriormente ha llamado lineDeallocateCall en ese identificador) dwParam2 se establece en NULL.
-
dwParam3
-
Si es cero, este parámetro indica que no ha habido ningún cambio en el privilegio de la aplicación para la llamada.
Si no es cero, especifica el privilegio de la aplicación para la llamada. Esto ocurre en las situaciones siguientes: (1) La primera vez que la aplicación recibe un identificador para esta llamada; (2) Cuando la aplicación es el destino de una entrega de llamada (incluso si la aplicación ya era propietaria de la llamada). Este parámetro usa una de las siguientes constantes LINECALLPRIVILEGE_.
Valor devuelto
No de devuelve ningún valor.
Comentarios
Este mensaje se envía a cualquier aplicación que tenga un identificador para la llamada. El mensaje LINE_CALLSTATE también notifica a las aplicaciones que supervisan las llamadas en una línea sobre la existencia y el estado de las llamadas salientes establecidas por otras aplicaciones o manualmente por el usuario (por ejemplo, en un dispositivo telefónico conectado). El estado de llamada de estas llamadas refleja el estado real de la llamada, que no está ofreciendo. Al examinar el estado de la llamada, la aplicación puede determinar si la llamada es una llamada entrante que debe responderse o no.
Se puede enviar un mensaje de LINE_CALLSTATE con un estado de llamada desconocido a una aplicación de supervisión como resultado de una lineMakeCall correcta, lineForward, lineUnpark, lineSetupTransfer, linePickup, lineSetupConference o linePrepareAddToConference solicitada por otra aplicación. Al mismo tiempo que la aplicación solicitante se envía un LINE_REPLY (correcto) para la operación solicitada, las aplicaciones de supervisión de la línea se envían el mensaje LINE_CALLSTATE (desconocido). Un mensaje de LINE_CALLSTATE que indica el estado de llamada "real" de la llamada recién generada se envía (mediante la información proporcionada por el proveedor de servicios) a las aplicaciones de solicitud y supervisión poco después.
Un mensaje de LINE_CALLSTATE (desconocido) se envía a las aplicaciones de supervisión solo si lineCompleteTransfer hace que las llamadas se resuelvan en una conferencia triple.
Por motivos de compatibilidad con versiones anteriores, las aplicaciones anteriores no esperan ningún valor determinado en dwParam2 de un mensaje de LINECALLSTATE_CONFERENCED. Por lo tanto, TAPI pasa la llamada primaria hConfCall en dwParam2 , independientemente de la versión de API de la aplicación que recibe el mensaje. En el caso de una llamada de conferencia iniciada por el proveedor de servicios, la aplicación anterior no es consciente de que la llamada primaria se ha convertido en una llamada de conferencia a menos que se produzca que examine espontáneamente otra información (por ejemplo, llame a lineGetConfRelatedCalls).
Este mensaje no se puede deshabilitar.
Requisitos
| Requisito | Value |
|---|---|
| Versión de TAPI |
Requiere TAPI 2.0 o posterior |
| Encabezado |
|