Función lineGetNumRings (tapi.h)

Artículo
03/02/2024

La función lineGetNumRings determina el número de llamadas entrantes en la dirección especificada antes de responder a la llamada.

Sintaxis

LONG lineGetNumRings(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPDWORD lpdwNumRings
);

Parámetros

hLine

Controle el dispositivo de línea abierta.

dwAddressID

Dirección en el dispositivo de línea. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

lpdwNumRings

Número de anillos que es el mínimo de todas las solicitudes lineSetNumRings actuales.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Comentarios

Las funciones lineGetNumRings y lineSetNumRings , cuando se usan en combinación, proporcionan un mecanismo para admitir la implementación de características de ahorro de peaje en varias aplicaciones independientes.

Una aplicación que recibe un identificador de una llamada en el estado de oferta y un mensaje de llamadade LINE_LINEDEVSTATE debe esperar un número de anillos igual al número devuelto por lineGetNumRings antes de responder a la llamada para respetar la configuración del protector de pago en todas las aplicaciones. La función lineGetNumRings devuelve el mínimo del número de anillos de todas las aplicaciones especificados por lineSetNumRings. Dado que este número puede variar dinámicamente, una aplicación debe invocar lineGetNumRings cada vez que tenga la opción de responder a una llamada. Si ninguna aplicación ha llamado a lineSetNumRings, se 0xFFFFFFFF el número de anillos devueltos. Se envía un mensaje de anillo LINE_LINEDEVSTATE independiente a la aplicación para cada ciclo de anillo.

Si tapi realiza la clasificación de llamadas para responder a todas las llamadas del modo multimedia desconocido y filtrar la secuencia multimedia, TAPI también respeta este número.

Nota Esta operación es puramente informativa y no afecta en sí mismo al estado de ninguna llamada en el dispositivo de línea.