messaggio LINE_LINEDEVSTATE
Il messaggio TAPI LINE_LINEDEVSTATE viene inviato quando lo stato di un dispositivo della riga è cambiato. L'applicazione può richiamare lineGetLineDevStatus per determinare il nuovo stato della riga.
Parametri
-
hDevice
-
Handle per il dispositivo di riga. Questo parametro è NULL quando dwParam1 è LINEDEVSTATE_REINIT.
-
dwCallbackInstance
-
Istanza di callback fornita quando si apre la riga. Se il parametro dwParam1 è LINEDEVSTATE_REINIT, il parametro dwCallbackInstance non è valido ed è impostato su zero.
-
dwParam1
-
Elemento di stato del dispositivo della riga modificato. Il parametro può essere una o più costanti LINEDEVSTATE_.
-
dwParam2
-
L'interpretazione di questo parametro dipende dal valore di dwParam1. Se dwParam1 è LINEDEVSTATE_RINGING, dwParam2 contiene la modalità anello con cui il commutatore indica la linea di anello. Le modalità di anello valide sono numeri nell'intervallo uno a dwNumRingModes, dove dwNumRingModes è una funzionalità del dispositivo linea.
Se dwParam1 è LINEDEVSTATE_REINIT e il messaggio è stato rilasciato da TAPI come risultato della traduzione di un nuovo messaggio API in un messaggio REINIT, dwParam2 contiene il parametro dwMsg del messaggio originale, ad esempio LINE_CREATE o LINE_LINEDEVSTATE . Se dwParam2 è zero, questo indica che il messaggio REINIT è un messaggio REINIT "reale" che richiede all'applicazione di chiamare lineShutdown alla massima praticità.
-
dwParam3
-
L'interpretazione di questo parametro dipende dal valore di dwParam1. Se dwParam1 è LINEDEVSTATE_RINGING, dwParam3 contiene il conteggio degli anelli per questo evento anello. Il conteggio degli anelli inizia a zero.
Se dwParam1 è LINEDEVSTATE_REINIT e il messaggio è stato rilasciato da TAPI come risultato della traduzione di un nuovo messaggio API in un messaggio REINIT, dwParam3 contiene il parametro dwParam1 del messaggio originale ,ad esempio LINEDEVSTATE_TRANSLATECHANGE o un altro valore LINEDEVSTATE_, se dwParam2 è LINE_LINEDEVSTATE o il nuovo identificatore del dispositivo, se dwParam2è LINE_CREATE).
Valore restituito
Nessun valore restituito.
Commenti
L'invio del messaggio di LINE_LINEDEVSTATE può essere controllato con lineSetStatusMessages. Un'applicazione può indicare le modifiche apportate all'elemento di stato su cui si vuole ricevere una notifica. Per impostazione predefinita, tutti i report sullo stato sono disabilitati, ad eccezione di LINEDEVSTATE_REINIT, che non possono essere disabilitati. Questo messaggio viene inviato a tutte le applicazioni che dispongono di un handle alla riga, incluse quelle denominate lineOpen con il parametro dwPrivileges impostate su LINECALLPRIVILEGE_NONE, LINECALLPRIVILEGE_OWNER, LINECALLPRIVILEGE_MONITOR o combinazioni consentite di queste.
Requisiti
| Requisito | Valore |
|---|---|
| Versione TAPI |
Richiede TAPI 2.0 o versione successiva |
| Intestazione |
|