Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La fonction lineGenerateDigits lance la génération des chiffres spécifiés sur l’appel spécifié sous forme de tonalités en bande à l’aide du mode de signalisation spécifié. L’appel de cette fonction avec une valeur NULL pour lpszDigits abandonne toute génération de chiffres en cours. Appeler lineGenerateDigits ou lineGenerateTone tandis que la génération de chiffres est en cours abandonne la génération de chiffres ou la génération de tonalité actuelle et lance la génération des chiffres ou du ton les plus récemment spécifiés.
Syntaxe
LONG lineGenerateDigitsA(
HCALL hCall,
DWORD dwDigitMode,
LPCSTR lpszDigits,
DWORD dwDuration
);
Paramètres
hCall
Gérer l’appel. L’application doit être propriétaire de l’appel. L’état d’appel de hCall peut être n’importe quel état. TAPI n’impose aucune exigence d’état d’appel, mais certains fournisseurs de services Tapi peuvent exiger que le hCall soit dans l’état LINECALLSTATE_CONNECTED.
dwDigitMode
Format à utiliser pour signaler ces chiffres. N’oubliez pas que dwDigitMode ne peut avoir qu’un seul indicateur défini. Ce paramètre utilise l’une des constantes LINEDIGITMODE_.
lpszDigits
Pointeur vers un mémoire tampon de caractères null-terminated qui contient les chiffres à générer. Les caractères valides sont ceux spécifiés pour les constantes LINEDIGITMODE_ fournies dans dwDigitModes.
En outre, la virgule (,) est également un caractère valide. Une virgule injecte un délai supplémentaire entre la signalisation des chiffres précédents et suivants qu’elle sépare. La durée de cette pause est définie par la configuration et les fonctionnalités de l’appareil de ligne indiquent cette durée. Plusieurs virgules peuvent être utilisées pour injecter des pauses plus longues. Les chiffres non valides sont ignorés pendant la génération, au lieu d’être signalés comme des erreurs.
L’exclamation ( !) est un caractère valide. Ce caractère provoque une opération « hookflash », comme décrit pour adresses rendez-vous.
dwDuration
Durée en millisecondes des chiffres DTMF et de l’espacement entre chiffres DTMF et DTMF. La valeur 0 utilise une valeur par défaut. Le paramètre dwDuration
Valeur de retour
Retourne zéro si la requête réussit ou si un numéro d’erreur négatif se produit. Les valeurs de retour possibles sont les suivantes :
LINEERR_INVALCALLHANDLE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDIGITMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.
Remarques
La fonction lineGenerateDigits est considérée comme ayant abouti lorsque la génération de chiffres a été lancée avec succès, et non lorsque tous les chiffres ont été générés. Contrairement à lineDial, qui compose les chiffres d’une manière dépendante du réseau, lineGenerateDigits garantit de produire les chiffres sous forme de tonalités en bande sur le canal vocal à l’aide des impulsions de numérotation DTMF ou hookswitch lors de l’utilisation d’une impulsion. La fonction lineGenerateDigits n’est généralement pas adaptée à l’appel ou à la numérotation. Elle est destinée à la signalisation de bout en bout sur un appel établi.
Une fois que tous les chiffres de lpszDigits ont été générés, ou après la génération de chiffres abandonnée ou annulée, un message LINE_GENERATE est envoyé à l’application.
Une seule demande de génération inband (génération de tonalité ou génération de chiffres) est autorisée à être en cours par appel sur toutes les applications propriétaires de l’appel. La génération de chiffres sur un appel est annulée en lançant une autre demande de génération de chiffres ou une demande de génération de tonalité. Pour annuler la génération de chiffres actuelle, l’application peut appeler lineGenerateDigits et spécifier NULL pour le paramètre lpszDigits.
Selon le fournisseur de services et le matériel, l’application peut surveiller les chiffres qu’elle génère lui-même. Si ce n’est pas le cas, l’application peut désactiver la surveillance des chiffres lors de la génération de chiffres.
Note
L’en-tête tapi.h définit lineGenerateDigits comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | tapi.h |
| bibliothèque | Tapi32.lib |
| DLL | Tapi32.dll |
Voir aussi
fonctions de service de ligne supplémentaires