Interface ITAutomatedPhoneControl (tapi3if.h)
ITAutomatedPhoneControl est une interface entièrement automatisable et scriptable OLE exposée par l’objet téléphonique TAPI. Lorsqu’un appareil téléphonique est ouvert avec des privilèges de propriétaire, vous pouvez appeler la méthode QueryInterface sur l’interface ITPhone pour obtenir un pointeur d’interface ITAutomatedPhoneControl .
Cette interface exécute plusieurs fonctions de haut niveau liées au téléphone :
- Activez et configurez le contrôle automatisé des sons et des sonneries du téléphone en fonction de l’entrée à partir de l’commutateur de raccordement et des boutons du téléphone.
- Activez et configurez la gestion automatisée des appels en fonction de l’état de hookswitch du téléphone. Par exemple, lorsque le téléphone est activé pendant qu’il gère un appel connecté, l’objet de téléphone peut appeler automatiquement ITBasicCallControl ::D isconnect sur cet appel.
- Générez des tonalités spécifiques sur les périphériques audio associés au téléphone, sans accéder directement aux API audio. Le contrôle de tonalité permet à une application de lire des tonalités sur les périphériques audio associés au téléphone, en dehors du contexte d’un appel. Étant donné que ces tonalités ne sont transmises sur aucun appel, elles sont indépendantes de la fonctionnalité de streaming audio accessible via les terminaux.
- Sonner le téléphone sans exiger d’informations sur la sonnerie du téléphone et, si le téléphone a une sonnerie, déterminer les types de sonneries que le téléphone prend en charge.
Héritage
L’interface ITAutomatedPhoneControl hérite de l’interface IDispatch. ITAutomatedPhoneControl a également les types de membres suivants :
Méthodes
L’interface ITAutomatedPhoneControl a ces méthodes.
| ITAutomatedPhoneControl ::EnumerateSelectedCalls La méthode EnumerateSelectedCalls récupère un objet énumérateur indiquant quels appels sont actuellement sélectionnés sur ce téléphone. Pour plus d’informations, consultez ITAutomatedPhoneControl ::SelectCall. |
| ITAutomatedPhoneControl ::get_AutoDialtone La méthode get_AutoDialtone récupère la valeur actuelle de la propriété AutoDialtone. |
| ITAutomatedPhoneControl ::get_AutoEndOfNumberTimeout La méthode get_AutoEndOfNumberTimeout récupère la valeur actuelle de la propriété AutoEndOfNumberTimeout. La propriété spécifie le temps d’attente après l’appui d’un chiffre avant de supposer que le nombre entier a été collecté. |
| ITAutomatedPhoneControl ::get_AutoKeypadTones La méthode get_AutoKeypadTones obtient la propriété AutoKeypadTones pour ce téléphone. Lorsque cette fonctionnalité est activée, une tonalité numérique est automatiquement lue chaque fois qu’un bouton du clavier est appuyé. |
| ITAutomatedPhoneControl ::get_AutoKeypadTonesMinimumDuration La méthode get_AutoKeypadTonesMinimumDuration récupère la valeur actuelle de la propriété AutoKeypadTonesMinimumDuration. La propriété spécifie la durée de lecture des tonalités du clavier sur PBS_DOWN. |
| ITAutomatedPhoneControl ::get_AutoStopRingOnOffHook La méthode get_AutoStopRingOnOffHook récupère la valeur actuelle de la propriété AutoStopRingOnOffHook. |
| ITAutomatedPhoneControl ::get_AutoStopTonesOnOnHook La méthode get_AutoStopTonesOnOnHook récupère la valeur actuelle de la propriété AutoStopTonesOnOnHook. |
| ITAutomatedPhoneControl ::get_AutoVolumeControl La méthode get_AutoVolumeControl récupère la valeur actuelle de la propriété AutoVolumeControl. |
| ITAutomatedPhoneControl ::get_AutoVolumeControlRepeatDelay La méthode get_AutoVolumeControlRepeatDelay récupère la valeur actuelle de la propriété AutoVolumeControlRepeatDelay. La propriété spécifie le délai, en millisecondes (ms), avant qu’un bouton de volume commence à se répéter lorsqu’il est maintenu enfoncé. |
| ITAutomatedPhoneControl ::get_AutoVolumeControlRepeatPeriod La méthode get_AutoVolumeControlRepeatPeriod récupère la valeur actuelle de la propriété AutoVolumeControlRepeatPeriod. La propriété contrôle la période, en millisecondes (ms), des répétitions de bouton lorsqu’un bouton de volume est maintenu hors service. |
| ITAutomatedPhoneControl ::get_AutoVolumeControlStep La méthode get_AutoVolumeControlStep récupère la valeur actuelle de la propriété AutoVolumeControlStep. La propriété détermine la quantité d’ajustement du volume du téléphone lorsque vous appuyez sur le bouton du volume. |
| ITAutomatedPhoneControl ::get_PhoneHandlingEnabled La méthode get_PhoneHandlingEnabled récupère la valeur actuelle de la propriété PhoneHandlingEnabled. |
| ITAutomatedPhoneControl ::get_Ringer La méthode get_Ringer retourne une valeur booléenne indiquant si le téléphone effectue actuellement une sonnerie entrante qui a été lancée par la méthode StartRinger sur cette interface. |
| ITAutomatedPhoneControl ::get_SelectedCalls La méthode get_SelectedCalls récupère un VARIANT contenant un pointeur vers un objet de collection indiquant quels appels sont actuellement sélectionnés sur ce téléphone. Pour plus d’informations, consultez ITAutomatedPhoneControl ::SelectCall. |
| ITAutomatedPhoneControl ::get_Tone La méthode get_Tone retourne une valeur d’énumération PHONE_TONE indiquant le type de tonalité, le cas échéant, que le téléphone est en cours de lecture. |
| ITAutomatedPhoneControl ::p ut_AutoDialtone La méthode put_AutoDialtone définit la valeur de la propriété AutoDialtone. |
| ITAutomatedPhoneControl ::p ut_AutoEndOfNumberTimeout La méthode put_AutoEndOfNumberTimeout définit la valeur de la propriété AutoEndOfNumberTimeout. La propriété spécifie le temps d’attente après l’appui d’un chiffre avant de supposer que le nombre entier a été collecté. |
| ITAutomatedPhoneControl ::p ut_AutoKeypadTones La méthode put_AutoKeypadTones définit la propriété AutoKeypadTones pour ce téléphone. Lorsque cette fonctionnalité est activée, une tonalité numérique est automatiquement lue chaque fois qu’un bouton du clavier est appuyé. |
| ITAutomatedPhoneControl ::p ut_AutoKeypadTonesMinimumDuration La méthode put_AutoKeypadTonesMinimumDuration définit la valeur de la propriété AutoKeypadTonesMinimumDuration. La propriété spécifie la durée de lecture des tonalités du clavier sur PBS_DOWN. |
| ITAutomatedPhoneControl ::p ut_AutoStopRingOnOffHook La méthode put_AutoStopRingOnOffHook définit la propriété AutoStopRingOnOffHook. Lorsque cette fonctionnalité est activée, l’arrêt du téléphone entraîne l’arrêt de toute sonnerie entrante produite sur le téléphone (via un appel à ITAutomatedPhoneControl ::StopRinger). |
| ITAutomatedPhoneControl ::p ut_AutoStopTonesOnHook La méthode put_AutoStopTonesOnOnHook définit la propriété AutoStopTonesOnOnHook pour ce téléphone. |
| ITAutomatedPhoneControl ::p ut_AutoVolumeControl La méthode put_AutoVolumeControl définit la propriété AutoVolumeControl pour ce téléphone. |
| ITAutomatedPhoneControl ::p ut_AutoVolumeControlRepeatDelay La méthode put_AutoVolumeControlRepeatDelay définit la propriété AutoVolumeControlRepeatDelay. La propriété spécifie le délai, en millisecondes (ms), avant qu’un bouton de volume commence à se répéter lorsqu’il est maintenu enfoncé. |
| ITAutomatedPhoneControl ::p ut_AutoVolumeControlRepeatPeriod La méthode put_AutoVolumeControlRepeatPeriod définit la propriété AutoVolumeControlRepeatPeriod. La propriété contrôle la période, en millisecondes (ms), des répétitions de bouton lorsqu’un bouton de volume est maintenu hors service. |
| ITAutomatedPhoneControl ::p ut_AutoVolumeControlStep La méthode put_AutoVolumeControlStep définit la propriété AutoVolumeControlStep. La propriété détermine la quantité d’ajustement du volume du téléphone lorsque vous appuyez sur le bouton du volume. |
| ITAutomatedPhoneControl ::p ut_PhoneHandlingEnabled La méthode put_PhoneHandlingEnabled définit la propriété PhoneHandlingEnabled. |
| ITAutomatedPhoneControl ::SelectCall La méthode SelectCall sélectionne l’objet téléphonique actuel sur l’objet Call pointé par le paramètre pCall. |
| ITAutomatedPhoneControl ::StartRinger La méthode StartRinger démarre la sonnerie du téléphone, en spécifiant le mode d’anneau et la durée de l’anneau. |
| ITAutomatedPhoneControl ::StartTone La méthode StartTone envoie des tonalités de contrôle. |
| ITAutomatedPhoneControl ::StopRinger La méthode StopRinger cesse tout anneau entrant en cours de production. Si aucun anneau n’est produit, la méthode n’effectue aucune action et retourne la réussite. |
| ITAutomatedPhoneControl ::StopTone La méthode StopTone cesse toute tonalité en cours de lecture. Si aucun ton n’est lu, la méthode n’effectue aucune action et retourne la réussite. |
| ITAutomatedPhoneControl ::UnselectCall La méthode UnselectCall supprime l’appel spécifié de cet objet téléphonique, ce qui libère la référence de l’objet phone à l’objet d’appel. |
Remarques
Un pointeur ITAutomatedPhoneControl devient non valide lorsque la méthode ITPhone ::Close est appelée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi3if.h (inclure Tapi3.h) |