PHONE_STATE mensagem
O TAPI envia a mensagem PHONE_STATE para um aplicativo sempre que o status de um dispositivo de telefone é alterado.
Parâmetros
-
hPhone
-
Um identificador para o dispositivo de telefone.
-
dwCallbackInstance
-
A instância de retorno de chamada do aplicativo fornecida ao abrir o dispositivo de telefone.
-
Dwparam1
-
O estado do telefone que foi alterado. Esse parâmetro usa uma das constantes PHONESTATE_.
-
Dwparam2
-
Informações dependentes de estado do telefone que detalham a alteração status. Esse parâmetro não será usado se vários sinalizadores forem definidos em dwParam1, pois vários itens de status foram alterados. O aplicativo deve invocar phoneGetStatus para obter um conjunto completo de informações.
Se dwParam1 for PHONESTATE_OWNER, dwParam2 conterá o novo número de proprietários.
Se dwParam1 for PHONESTATE_MONITORS, dwParam2 conterá o novo número de monitores.
Se dwParam1 for PHONESTATE_LAMP, dwParam2 conterá o identificador de botão/lâmpada da lâmpada que foi alterada.
Se dwParam1 for PHONESTATE_RINGMODE, dwParam2 conterá o novo modo de anel.
Se dwParam1 for PHONESTATE_HANDSET, SPEAKER ou HEADSET, dwParam2 conterá o novo modo hookswitch desse dispositivo hookswitch. Esse parâmetro usa uma das constantes PHONEHOOKSWITCHMODE_.
-
dwParam3
-
Não utilizado.
Valor retornado
Sem valor de retorno.
Comentários
O envio da mensagem PHONE_STATE para o aplicativo pode ser controlado e consultado usando phoneSetStatusMessages e phoneGetStatusMessages. Por padrão, essa mensagem é desabilitada para todas as alterações de estado, exceto para PHONESTATE_REINIT, que não podem ser desabilitadas. Essa mensagem é enviada a todos os aplicativos que têm um identificador para o telefone, incluindo aqueles que chamaram phoneOpen com o parâmetro dwPrivileges definido como PHONEPRIVILEGE_OWNER ou PHONEPRIVILEGE_MONITOR.
Uma mensagem PHONE_STATE com uma indicação Proprietários e/ou Monitores é enviada para aplicativos que já têm um identificador para o telefone. Isso pode ser o resultado de outro aplicativo alterando a propriedade ou o monitoramento do dispositivo de telefone com phoneOpen, phoneClose ou phoneShutdown.
Requisitos
| Requisito | Valor |
|---|---|
| Versão do TAPI |
Requer TAPI 2.0 ou posterior |
| Cabeçalho |
|