Partager via


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
Tapi.h

Voir aussi

LINE_CLOSE

LINE_CREATE

LINEDEVCAPS

lineGetDevCaps

lineGetDevConfig

lineGetTranslateCaps

lineInitialize

lineOpen

lineSetStatusMessages

lineShutdown

LINETRANSLATECAPS

lineUncompleteCall