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

Consulte también

PHONE_CLOSE

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneOpen

phoneSetStatusMessages

phoneShutdown