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	Tapi.h

Consulte también

LINE_CLOSE

LINE_CREATE

LINEDEVCAPS

lineGetDevCaps

lineGetDevConfig

lineGetTranslateCaps

lineInitialize

lineOpen

lineSetStatusMessages

lineShutdown

LINETRANSLATECAPS

lineUncompleteCall