PHONE_STATE mensaje
TAPI envía el mensaje PHONE_STATE a una aplicación cada vez que cambia el estado de un dispositivo telefónico.
Parámetros
-
hPhone
-
Identificador del dispositivo telefónico.
-
dwCallbackInstance
-
La instancia de devolución de llamada de la aplicación proporcionada al abrir el dispositivo telefónico.
-
dwParam1
-
Estado del teléfono que ha cambiado. Este parámetro usa una de las constantes PHONESTATE_.
-
dwParam2
-
Información dependiente del estado del teléfono que detalla el cambio de estado. Este parámetro no se usa si se establecen varias marcas en dwParam1, porque han cambiado varios elementos de estado. La aplicación debe invocar phoneGetStatus para obtener un conjunto completo de información.
Si dwParam1 es PHONESTATE_OWNER, dwParam2 contiene el nuevo número de propietarios.
Si dwParam1 es PHONESTATE_MONITORS, dwParam2 contiene el nuevo número de monitores.
Si dwParam1 es PHONESTATE_LAMP, dwParam2 contiene el identificador de botón o lámpara de la lámpara que ha cambiado.
Si dwParam1 está PHONESTATE_RINGMODE, dwParam2 contiene el nuevo modo de anillo.
Si dwParam1 es PHONESTATE_HANDSET, SPEAKER o HEADSET, dwParam2 contiene el nuevo modo hookswitch de ese dispositivo hookswitch. Este parámetro usa una de las constantes PHONEHOOKSWITCHMODE_.
-
dwParam3
-
Sin usar.
Valor devuelto
No de devuelve ningún valor.
Comentarios
El envío del mensaje PHONE_STATE a la aplicación se puede controlar y consultar mediante phoneSetStatusMessages y phoneGetStatusMessages. De forma predeterminada, este mensaje está deshabilitado para todos los cambios de estado, excepto para PHONESTATE_REINIT, que no se pueden deshabilitar. Este mensaje se envía a todas las aplicaciones que tienen un identificador para el teléfono, incluidas las llamadas phoneOpen con el parámetro dwPrivileges establecido en PHONEPRIVILEGE_OWNER o PHONEPRIVILEGE_MONITOR.
Se envía un mensaje de PHONE_STATE con los propietarios o monitores a las aplicaciones que ya tienen un identificador para el teléfono. Esto puede ser el resultado de que otra aplicación cambie la propiedad o la supervisión del dispositivo telefónico con phoneOpen, phoneClose o phoneShutdown.
Requisitos
| Requisito | Value |
|---|---|
| Versión de TAPI |
Requiere TAPI 2.0 o posterior |
| Encabezado |
|