Botões do telefone

A TAPI modela os botões e lâmpadas de um telefone como pares de lâmpadas-botão. Um botão sem lâmpada ao lado ou uma lâmpada sem botão é especificado usando um indicador "fictício" para a lâmpada ou botão ausente. Um botão com várias lâmpadas é modelado usando vários pares de lâmpadas-botão.

As informações associadas a um botão do telefone podem ser definidas e recuperadas. Quando um botão é pressionado, uma mensagem PHONE_BUTTON é enviada para a função do aplicativo. Os parâmetros desta mensagem são um identificador para o dispositivo do telefone e o identificador da lâmpada de botão do botão que foi pressionado. Os botões do teclado '0' a '9', '*' e '#' recebem os identificadores fixos de lâmpada de botão de 0 a 11.

As funções associadas aos botões são phoneSetButtonInfo, que define as informações associadas a um botão em um dispositivo de telefone, e phoneGetButtonInfo, que retorna informações associadas a um botão em um dispositivo de telefone. A mensagem PHONE_BUTTON é enviada para um aplicativo quando um botão no telefone é pressionado.

A informação associada a um botão não tem qualquer significado semântico no que diz respeito à TAPI. É útil para aplicativos específicos do dispositivo que entendem o significado dessas informações para um determinado dispositivo telefônico, ou para exibição ao usuário, como ajuda on-line.