mensaje de LINE_LINEDEVSTATE
El mensaje de LINE_LINEDEVSTATE TAPI se envía cuando el estado de un dispositivo de línea ha cambiado. La aplicación puede invocar lineGetLineDevStatus para determinar el nuevo estado de la línea.
Parámetros
-
hDevice
-
Identificador del dispositivo de línea. Este parámetro es NULL cuando dwParam1 es LINEDEVSTATE_REINIT.
-
dwCallbackInstance
-
La instancia de devolución de llamada proporcionada al abrir la línea. Si el parámetro dwParam1 es LINEDEVSTATE_REINIT, el parámetro dwCallbackInstance no es válido y se establece en cero.
-
dwParam1
-
Elemento de estado del dispositivo de línea que ha cambiado. El parámetro puede ser una o varias de las constantes LINEDEVSTATE_.
-
dwParam2
-
La interpretación de este parámetro depende del valor de dwParam1. Si dwParam1 es LINEDEVSTATE_RINGING, dwParam2 contiene el modo de anillo con el que el modificador indica a la línea que se va a anillo. Los modos de anillo válidos son números del intervalo uno para dwNumRingModes, donde dwNumRingModes es una funcionalidad de dispositivo de línea.
Si dwParam1 es LINEDEVSTATE_REINIT y TAPI emitió el mensaje como resultado de la traducción de un nuevo mensaje de API en un mensaje REINIT, dwParam2 contiene el parámetro dwMsg del mensaje original (por ejemplo, LINE_CREATE o LINE_LINEDEVSTATE ). Si dwParam2 es cero, esto indica que el mensaje REINIT es un mensaje REINIT "real" que requiere que la aplicación llame a lineShutdown lo antes posible.
-
dwParam3
-
La interpretación de este parámetro depende del valor de dwParam1. Si dwParam1 es LINEDEVSTATE_RINGING, dwParam3 contiene el recuento de anillos para este evento de anillo. El recuento de anillos comienza en cero.
Si dwParam1 es LINEDEVSTATE_REINIT y TAPI emitió el mensaje como resultado de la traducción de un nuevo mensaje de API en un mensaje REINIT, dwParam3 contiene el parámetro dwParam1 del mensaje original (por ejemplo, LINEDEVSTATE_TRANSLATECHANGE o algún otro valor de LINEDEVSTATE_, si dwParam2 es LINE_LINEDEVSTATE o el nuevo identificador de dispositivo, si dwParam2 es LINE_CREATE).
Valor devuelto
No de devuelve ningún valor.
Comentarios
El envío del mensaje de LINE_LINEDEVSTATE se puede controlar con lineSetStatusMessages. Una aplicación puede indicar cambios en los elementos de estado sobre los que desea recibir una notificación. De forma predeterminada, todos los informes de estado están deshabilitados, excepto por LINEDEVSTATE_REINIT, que no se pueden deshabilitar. Este mensaje se envía a todas las aplicaciones que tienen un identificador para la línea, incluidas las que llaman lineOpen con el parámetro dwPrivileges establecido en LINECALLPRIVILEGE_NONE, LINECALLPRIVILEGE_OWNER, LINECALLPRIVILEGE_MONITOR o combinaciones permitidas de estos.
Requisitos
| Requisito | Value |
|---|---|
| Versión de TAPI |
Requiere TAPI 2.0 o posterior |
| Encabezado |
|