Botões de telefone

O TAPI modela botões e lâmpadas de um telefone como pares de lâmpadas de 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 de botão.

As informações associadas a um botão de telefone podem ser definidas e recuperadas. Quando um botão é pressionado, uma mensagem PHONE_BUTTON é enviada para a função de aplicativo. Os parâmetros dessa mensagem são um identificador para o dispositivo de telefone e o identificador de 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 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.

As informações associadas a um botão não têm nenhum significado semântico no que diz respeito ao TAPI. É útil para aplicativos específicos do dispositivo que entendem o significado dessas informações para um determinado dispositivo de telefone ou para exibição para o usuário, como ajuda online.