ITLegacyCallMediaControl2 ::D etectTones, méthode (tapi3if.h)
La méthode DetectTones active et désactive la détection des tonalités de bande sur l’appel. Chaque fois qu’un ton spécifié est détecté, un message est envoyé à l’application.
Cette méthode est destinée aux applications C/C++. Visual Basic et les applications de script doivent utiliser la méthode DetectTonesByCollection à la place.
Syntaxe
HRESULT DetectTones(
[in] TAPI_DETECTTONE *pToneList,
[in] long lNumTones
);
Paramètres
[in] pToneList
Pointeur vers un tableau TAPI_DETECTTONE qui spécifie les tonalités à détecter. Chaque tonalité du tableau a un champ de balise défini par l’application qui est utilisé pour identifier les tons individuels dans la liste lorsqu’un événement de détection de tonalité de type TE_TONEEVENT est signalé. Pour plus d'informations, consultez la section Notes qui suit.
[in] lNumTones
Nombre d’entrées dans le tableau spécifié par le paramètre pToneList . Ce paramètre est ignoré si pToneList a la valeurNULL.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La méthode a réussi. |
|
Le paramètre pToneList n’est pas un pointeur valide. |
|
L’appel doit être à l’état connecté . |
Remarques
Cette méthode se traduit par un TAPI 2. xlineMonitorTones appel.
Pour annuler l’analyse de tonalité en cours, appelez la méthode DetectTones et spécifiez un paramètre pToneListNULL. Pour modifier la liste des tons à surveiller, appelez cette méthode et spécifiez une nouvelle liste de tonalités.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi3if.h |
| Bibliothèque | Uuid.lib |
| DLL | Tapi3.dll |