LINE_LINEDEVSTATE message
Le message d’LINE_LINEDEVSTATE TAPI est envoyé lorsque l’état d’un périphérique de ligne a changé. L’application peut appeler lineGetLineDevStatus pour déterminer la nouvelle status de la ligne.
Paramètres
-
hDevice
-
Handle pour l’appareil de ligne. Ce paramètre a la valeur NULL lorsque dwParam1 est LINEDEVSTATE_REINIT.
-
dwCallbackInstance
-
Le rappel instance fourni lors de l’ouverture de la ligne. Si le paramètre dwParam1 est LINEDEVSTATE_REINIT, le paramètre dwCallbackInstance n’est pas valide et est défini sur zéro.
-
dwParam1
-
L’appareil de ligne status élément qui a été modifié. Le paramètre peut être une ou plusieurs constantes LINEDEVSTATE_.
-
dwParam2
-
L’interprétation de ce paramètre dépend de la valeur de dwParam1. Si dwParam1 est LINEDEVSTATE_RINGING, dwParam2 contient le mode d’anneau avec lequel le commutateur indique à la ligne de sonner. Les modes d’anneau valides sont des nombres entre un et dwNumRingModes, où dwNumRingModes est une fonctionnalité d’appareil de ligne.
Si dwParam1 est LINEDEVSTATE_REINIT et que le message a été émis par TAPI à la suite de la traduction d’un nouveau message d’API en message REINIT, dwParam2 contient le paramètre dwMsg du message d’origine (par exemple , LINE_CREATE ou LINE_LINEDEVSTATE). Si dwParam2 est égal à zéro, cela indique que le message REINIT est un message REINIT « réel » qui nécessite que l’application appelle lineShutdown dans les plus brefs délais.
-
dwParam3
-
L’interprétation de ce paramètre dépend de la valeur de dwParam1. Si dwParam1 est LINEDEVSTATE_RINGING, dwParam3 contient le nombre d’anneaux pour cet événement d’anneau. Le nombre d’anneaux commence à zéro.
Si dwParam1 est LINEDEVSTATE_REINIT et que le message a été émis par TAPI à la suite de la traduction d’un nouveau message d’API en message REINIT, dwParam3 contient le paramètre dwParam1 du message d’origine (par exemple, LINEDEVSTATE_TRANSLATECHANGE ou une autre valeur LINEDEVSTATE_, si dwParam2 est LINE_LINEDEVSTATE, ou le nouvel identificateur d’appareil, si dwParam2 est LINE_CREATE).
Valeur retournée
Pas de valeur de retour.
Notes
L’envoi du message LINE_LINEDEVSTATE peut être contrôlé avec lineSetStatusMessages. Une application peut indiquer status modifications d’élément dont elle souhaite être avertie. Par défaut, tous les rapports status sont désactivés, à l’exception des LINEDEVSTATE_REINIT, qui ne peuvent pas être désactivés. Ce message est envoyé à toutes les applications qui ont un handle à la ligne, y compris celles qui ont appelé lineOpen avec le paramètre dwPrivileges défini sur LINECALLPRIVILEGE_NONE, LINECALLPRIVILEGE_OWNER, LINECALLPRIVILEGE_MONITOR ou des combinaisons autorisées de ces derniers.
Spécifications
Condition requise | Valeur |
---|---|
Version TAPI |
Nécessite TAPI 2.0 ou version ultérieure |
En-tête |
|
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour