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

Vedi anche

PHONE_CLOSE

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneOpen

phoneSetStatusMessages

phoneShutdown