MÉTHODE ITLegacyCallMediaControl2 ::D etectTonesByCollection (tapi3if.h)
La méthode DetectTonesByCollection active et désactive la détection des tonalités inband sur l’appel. Chaque fois qu’une tonalité spécifiée est détectée, un message est envoyé à l’application.
Cette méthode est destinée aux applications Visual Basic et de script. Les applications C/C++ doivent utiliser la méthode DetectTones à la place.
Syntaxe
HRESULT DetectTonesByCollection(
[in] ITCollection2 *pDetectToneCollection
);
Paramètres
[in] pDetectToneCollection
Pointeur vers une interface ITCollection2 contenant une collection de pointeurs d’interface ITDetectTone qui représentent les tonalités à surveiller. Chaque tonalité de la liste a un champ de balise défini par l’application qui est utilisé pour identifier les sons individuels lorsque la détection de tonalité est signalée par un événement TE_TONEEVENT . Pour plus d'informations, consultez la section Notes qui suit.
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 pDetectToneCollection n’est pas un pointeur valide. |
|
La mémoire est insuffisante pour allouer la mémoire tampon des tonalités. |
|
L’appel doit être dans l’état connecté . |
Remarques
Cette méthode se traduit par un TAPI 2. xlineMonitorTones call.
Pour annuler l’analyse de tonalité en cours, appelez la méthode DetectTonesByCollection et spécifiez une collection vide. Pour modifier la liste des tonalités à surveiller, appelez cette méthode et spécifiez une nouvelle collection de tonalités.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi3if.h |
| Bibliothèque | Uuid.lib |
| DLL | Tapi3.dll |