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

Confira também

PHONE_CLOSE

PHONECAPS

phoneClose

Phonegetdevcaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

Phoneinitializeex

phoneOpen

phoneSetStatusMessages

Phoneshutdown