fonction lineMonitorDigits (tapi.h)

Article
03/02/2024

La fonction lineMonitorDigits active et désactive la détection sans débogage des chiffres reçus sur l’appel. Chaque fois qu’un chiffre du mode de chiffres spécifié est détecté, un message est envoyé à l’application indiquant quel chiffre a été détecté.

Syntaxe

LONG lineMonitorDigits(
  HCALL hCall,
  DWORD dwDigitModes
);

Paramètres

hCall

Gérer l’appel sur lequel les chiffres doivent être détectés. L’état de l’appel de hCall peut être n’importe quel état, sauf inactif ou déconnecté.

dwDigitModes

Mode numérique ou modes à surveiller. Si dwDigitModes est égal à zéro, l’analyse des chiffres est annulée. Ce paramètre utilise une ou plusieurs constantes LINEDIGITMODE_.

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALDIGITMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Remarques

Cette fonction est considérée comme réussie si l’analyse des chiffres a été correctement lancée, et non lorsque l’analyse des chiffres a pris fin. La surveillance des chiffres reste en vigueur jusqu’à ce qu’elle soit explicitement désactivée en appelant lineMonitorDigits avec dwDigitModes défini sur zéro, jusqu’à ce que l’appel passe au mode inactif ou lorsque l’application libère son handle d’appel pour l’appel. Bien que cette fonction puisse être appelée dans n’importe quel état d’appel, les chiffres sont généralement détectés uniquement lorsque l’appel est à l’état connecté .

Chaque fois qu’un chiffre est détecté, un message LINE_MONITORDIGITS est envoyé à l’application en passant le chiffre détecté en tant que paramètre.

Une application peut utiliser lineMonitorDigits pour activer ou désactiver la détection de chiffres sans débogage. Il peut utiliser lineGatherDigits pour la détection de chiffres mis en mémoire tampon. Une fois la collecte de chiffres mis en mémoire tampon terminée, un message LINE_GATHERDIGITS est envoyé à l’application. La détection de chiffres mis en mémoire tampon et non tamponnée peut être activée simultanément sur le même appel.

La surveillance des chiffres d’une téléconférence s’applique uniquement à hConfCall, et non aux appels individuels participants.