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 |
|