Botões (API de Telefonia)
A Microsoft Telephony 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, o provedor de serviços envia uma mensagem PHONE_BUTTON para a função de retorno de chamada TAPI. Os parâmetros dessa mensagem são um identificador para o dispositivo de telefone e o identificador de botão/lâmpada do botão que foi pressionado. O botão do teclado '0' a '9', '*' e '#' são atribuídos identificadores fixos de botão/lâmpada de 0 a 11.
A função TSPI_phoneSetButtonInfo define as informações associadas a um botão em um dispositivo de telefone. TSPI_phoneGetButtonInfo retorna informações associadas a um botão em um dispositivo de telefone. O provedor de serviços envia uma mensagem PHONE_BUTTON para a função de retorno de chamada TAPI 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 TSPI. É útil para aplicativos específicos do dispositivo que interpretam essas informações para um determinado dispositivo de telefone ou para exibição para o usuário, como no sistema de ajuda de um aplicativo.