fonction TSPI_lineAnswer (tspi.h)

Article
03/03/2024

La fonction TSPI_lineAnswer répond à l’appel d’offre spécifié.

Syntaxe

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

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdCall

Le handle du fournisseur de services à l’appel à répondre. L’état de l’appel de hdCall peut être proposé ou accepté.

lpsUserUserInfo

Pointeur vers une chaîne terminée par null contenant des informations utilisateur-utilisateur à envoyer à la partie distante au moment de répondre à l’appel. Si ce pointeur a la valeur NULL, cela indique qu’aucune information utilisateur ne doit être envoyée. Les informations utilisateur-utilisateur sont envoyées uniquement si le réseau sous-jacent est pris en charge (comme indiqué dans LINEDEVCAPS).

dwSize

Taille en octets des informations utilisateur-utilisateur dans lpsUserUserInfo. Si lpsUserUserInfo a la valeur NULL, dwSize est ignoré.

Valeur retournée

Retourne dwRequestID ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult de la ASYNC_COMPLETION correspondante est zéro si la fonction réussit ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

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

Remarques

Lorsqu’un nouvel appel arrive, le fournisseur de services envoie à TAPI un message LINE_NEWCALL pour échanger des handles pour l’appel. Le fournisseur de services le suit avec un message LINE_CALLSTATE pour informer TAPI et ses applications clientes de l’état de l’appel. Une application cliente répond généralement à l’appel à l’aide de TSPI_lineAnswer. En règle générale, une fois l’appel correctement répondu, l’appel passe à l’état connecté .

Dans certains environnements de téléphonie (comme ISDN) où l’alerte utilisateur est distincte de l’offre d’appel, TAPI et ses applications clientes peuvent avoir la possibilité d’accepter d’abord un appel avant de répondre, ou plutôt de rejeter ou de rediriger l’appel de l’offre .

Si un appel est proposé au moment où un autre appel est déjà actif, le nouvel appel est connecté à en appelant TSPI_lineAnswer. L’effet de cette opération sur l’appel actif existant dépend des fonctionnalités de l’appareil de la ligne. Le premier appel n’est peut-être pas affecté, il peut être automatiquement supprimé ou il peut être automatiquement mis en attente. Les messages LINE_CALLSTATE appropriés sont utilisés pour signaler les transitions d’état vers TAPI pour les deux appels.