Fonction de rappel LINEEVENT (tspi.h)

Line_Event est une fonction de rappel implémentée par TAPI et fournie au fournisseur de services en tant que paramètre pour TSPI_lineOpen. Le fournisseur de services appelle cette fonction pour signaler les événements qui se produisent sur la ligne ou sur les appels sur la ligne.

Le type LINEEVENT définit un pointeur vers cette fonction de rappel. Line_Event est un espace réservé pour le nom de fonction défini par l’application.

Syntaxe

LINEEVENT Lineevent;

void Lineevent(
  HTAPILINE htLine,
  HTAPICALL htCall,
  DWORD dwMsg,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2,
  DWORD_PTR dwParam3
)
{...}

Paramètres

htLine

Handle TAPI pour la ligne sur laquelle l’événement s’est produit.

htCall

Handle TAPI pour l’appel sur lequel l’événement s’est produit s’il s’agit d’un événement lié à l’appel. Pour les événements liés à la ligne où il n’y a pas d’appel, ce paramètre est défini sur NULL.

dwMsg

Spécifie le type d’événement signalé. L’interprétation des autres paramètres est effectuée de différentes manières en fonction du contexte indiqué par dwMsg.

dwParam1

Paramètre pour le message.

dwParam2

Paramètre pour le message.

dwParam3

Paramètre pour le message.

Valeur de retour

None

Remarques

L’état d’appel lors de l’appel de cette fonction peut être n’importe quel état.

Le fournisseur de services transmet la valeur HTAPILINE fournie à TSPI_lineOpen en tant que paramètre htLine . Il inclut l’identificateur de message et les paramètres spécifiques à l’événement.

Cette fonction diffère de la fonction de rappel définie au niveau TAPI en ce qu’elle sépare les paramètres de ligne et d’appel. Les deux paramètres sont utilisés pour certains messages. Les ensembles de messages qui peuvent être transmis à cette procédure diffèrent légèrement du niveau TAPI. En particulier, l’achèvement des requêtes en cours d’exécution asynchrone est signalé via le rappel Completion_Proc au lieu de celui-ci.

Configuration requise

Voir aussi

Completion_Proc

TSPI_lineOpen