messaggio di PHONE_STATE
TAPI invia il messaggio PHONE_STATE a un'applicazione ogni volta che cambia lo stato di un dispositivo telefonico.
Parametri
-
hPhone
-
Handle per il dispositivo telefonico.
-
dwCallbackInstance
-
Istanza di callback dell'applicazione fornita all'apertura del dispositivo telefonico.
-
dwParam1
-
Stato del telefono modificato. Questo parametro usa una delle costanti PHONESTATE_.
-
dwParam2
-
Informazioni dipendenti dallo stato del telefono che descrivono in dettaglio la modifica dello stato. Questo parametro non viene usato se sono impostati più flag in dwParam1, perché sono stati modificati più elementi di stato. L'applicazione deve richiamare phoneGetStatus per ottenere un set completo di informazioni.
Se dwParam1 è PHONESTATE_OWNER, dwParam2 contiene il nuovo numero di proprietari.
Se dwParam1 è PHONESTATE_MONITORS, dwParam2 contiene il nuovo numero di monitoraggi.
Se dwParam1 è PHONESTATE_LAMP, dwParam2 contiene l'identificatore pulsante/lampada della lampada modificata.
Se dwParam1 è PHONESTATE_RINGMODE, dwParam2 contiene la nuova modalità anello.
Se dwParam1 è PHONESTATE_HANDSET, SPEAKER o HEADSET, dwParam2 contiene la nuova modalità hookswitch del dispositivo hookswitch. Questo parametro usa una delle costanti PHONEHOOKSWITCHMODE_.
-
dwParam3
-
Non utilizzato.
Valore restituito
Nessun valore restituito.
Commenti
L'invio del messaggio di PHONE_STATE all'applicazione può essere controllato ed sottoposto a query usando phoneSetStatusMessages e phoneGetStatusMessages. Per impostazione predefinita, questo messaggio è disabilitato per tutte le modifiche dello stato ad eccezione di PHONESTATE_REINIT, che non può essere disabilitato. Questo messaggio viene inviato a tutte le applicazioni che hanno un handle al telefono, incluse quelle chiamate phoneOpen con il parametro dwPrivileges impostato su PHONEPRIVILEGE_OWNER o PHONEPRIVILEGE_MONITOR.
Un messaggio PHONE_STATE con un'indicazione Proprietari e/o Monitoraggi viene inviata alle applicazioni che hanno già un handle per il telefono. Questo può essere il risultato di un'altra applicazione che modifica la proprietà o il monitoraggio del dispositivo telefonico con phoneOpen, phoneClose o phoneShutdown.
Requisiti
| Requisito | Valore |
|---|---|
| Versione TAPI |
Richiede TAPI 2.0 o versione successiva |
| Intestazione |
|