TSPI_lineAnswer función (tspi.h)

Artículo
03/03/2024

La función TSPI_lineAnswer responde a la llamada de oferta especificada.

Sintaxis

LONG TSPIAPI TSPI_lineAnswer(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Parámetros

dwRequestID

Identificador de la solicitud asincrónica.

hdCall

Identificador del proveedor de servicios a la llamada que se va a responder. El estado de llamada de hdCallpuede ofrecerse o aceptarse.

lpsUserUserInfo

Puntero a una cadena terminada en null que contiene información de usuario-usuario que se enviará a la parte remota en el momento de responder a la llamada. Si este puntero es NULL, indica que no se enviará ninguna información de usuario-usuario. La información del usuario solo se envía si es compatible con la red subyacente (como se indica en LINEDEVCAPS).

dwSize

Tamaño en bytes de la información de usuario-usuario en lpsUserUserInfo. Si lpsUserUserInfo es NULL, dwSize se omite.

Valor devuelto

Devuelve dwRequestID o un número de error si se produce un error. El parámetro real lResult del ASYNC_COMPLETION correspondiente es cero si la función se realiza correctamente o si se produce un error. Los valores devueltos posibles son los siguientes:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INUSE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG.

Comentarios

Cuando llega una nueva llamada, el proveedor de servicios envía a TAPI un mensaje de LINE_NEWCALL para intercambiar identificadores de la llamada. El proveedor de servicios lo sigue con un mensaje de LINE_CALLSTATE para informar a TAPI y sus aplicaciones cliente del estado de la llamada. Normalmente, una aplicación cliente responde a la llamada mediante TSPI_lineAnswer. Normalmente, después de que la llamada se responda correctamente, la llamada pasa al estado conectado .

En algunos entornos de telefonía (como ISDN), donde las alertas de usuario son independientes de la oferta de llamadas, TAPI y sus aplicaciones cliente pueden tener la opción de aceptar primero una llamada antes de responder, o en su lugar rechazar o redirigir la llamada de oferta .

Si se ofrece una llamada en el momento en que otra llamada ya está activa, la nueva llamada se conecta invocando TSPI_lineAnswer. El efecto que esto tiene en la llamada activa existente depende de las funcionalidades del dispositivo de la línea. La primera llamada puede no verse afectada, se puede quitar automáticamente o se puede colocar automáticamente en espera. Los mensajes de LINE_CALLSTATE adecuados se usan para notificar las transiciones de estado a TAPI sobre ambas llamadas.