PHONE_STATE message
TAPI envoie le message PHONE_STATE à une application chaque fois que le status d’un appareil téléphonique change.
Paramètres
-
hPhone
-
Poignée de l’appareil téléphonique.
-
dwCallbackInstance
-
Le rappel de l’application instance fourni lors de l’ouverture de l’appareil téléphonique.
-
dwParam1
-
État du téléphone qui a changé. Ce paramètre utilise l’une des constantes PHONESTATE_.
-
dwParam2
-
Informations dépendantes de l’état du téléphone détaillant le changement status. Ce paramètre n’est pas utilisé si plusieurs indicateurs sont définis dans dwParam1, car plusieurs éléments status ont été modifiés. L’application doit appeler phoneGetStatus pour obtenir un ensemble complet d’informations.
Si dwParam1 est PHONESTATE_OWNER, dwParam2 contient le nouveau nombre de propriétaires.
Si dwParam1 est PHONESTATE_MONITORS, dwParam2 contient le nouveau nombre de moniteurs.
Si dwParam1 est PHONESTATE_LAMP, dwParam2 contient l’identificateur de bouton/lampe de la lampe qui a changé.
Si dwParam1 est PHONESTATE_RINGMODE, dwParam2 contient le nouveau mode anneau.
Si dwParam1 est PHONESTATE_HANDSET, SPEAKER ou HEADSET, dwParam2 contient le nouveau mode hookswitch de cet appareil. Ce paramètre utilise l’une des constantes PHONEHOOKSWITCHMODE_.
-
dwParam3
-
Inutilisé.
Valeur retournée
Pas de valeur de retour.
Notes
L’envoi du message PHONE_STATE à l’application peut être contrôlé et interrogé à l’aide de phoneSetStatusMessages et phoneGetStatusMessages. Par défaut, ce message est désactivé pour toutes les modifications d’état, à l’exception des PHONESTATE_REINIT, qui ne peuvent pas être désactivés. Ce message est envoyé à toutes les applications qui ont un handle sur le téléphone, y compris celles qui ont appelé phoneOpen avec le paramètre dwPrivileges défini sur PHONEPRIVILEGE_OWNER ou PHONEPRIVILEGE_MONITOR.
Un message PHONE_STATE avec une indication Propriétaires et/ou Moniteurs est envoyé aux applications qui disposent déjà d’un handle pour le téléphone. Cela peut être le résultat d’un changement de propriété ou de surveillance d’une autre application de l’appareil téléphonique avec phoneOpen, phoneClose ou phoneShutdown.
Spécifications
| Condition requise | Valeur |
|---|---|
| Version TAPI |
Nécessite TAPI 2.0 ou version ultérieure |
| En-tête |
|