Función lineGetNumRings (tapi.h)

La función lineGetNumRings determina el número de anillos de una llamada entrante 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.

Observaciones

Las lineGetNumRings y funciones 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 que ofrece estado y un LINE_LINEDEVSTATE mensaje de llamada 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 peaje en todas las aplicaciones. La función lineGetNumRings devuelve el mínimo del número mínimo 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 no se ha llamado a ninguna aplicación lineSetNumRings, se 0xFFFFFFFF el número de anillos devueltos. Se envía un mensaje de LINE_LINEDEVSTATE anillo 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 las llamadas en el dispositivo de línea.

 

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	tapi.h
biblioteca de	Tapi32.lib
DLL de	Tapi32.dll

Consulte también

referencia de servicios de telefonía básica de

LINE_LINEDEVSTATE

de información general de referencia de TAPI 2.2

lineSetNumRings