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

Vedi anche

LINE_CLOSE

LINE_CREATE

LINEDEVCAPS

lineGetDevCaps

lineGetDevConfig

lineGetTranslateCaps

lineInitialize

lineOpen

lineSetStatusMessages

lineShutdown

LINETRANSLATECAPS

lineUncompleteCall