Método ITAutomatedPhoneControl::p ut_AutoKeypadTones (tapi3if.h)

Artigo
03/02/2024

O método put_AutoKeypadTones define a propriedade AutoKeypadTones para este telefone. Quando esse recurso está habilitado, um tom de dígito é reproduzido automaticamente sempre que um botão do teclado é pressionado.

Sintaxe

HRESULT put_AutoKeypadTones(
  [in] VARIANT_BOOL fEnabled
);

Parâmetros

[in] fEnabled

Se VARIANT_TRUE, a geração automática de tom do teclado do telefone estará habilitada. Se VARIANT_FALSE, a geração de tom do teclado será desabilitada. O valor padrão é VARIANT_TRUE.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Caso contrário, ele retornará um valor de erro.

Comentários

Se o dispositivo de telefone relatar um pressionamento de botão como PBS_DOWN, o tom será reproduzido até que o dispositivo de telefone reporte um evento de PBS_UP ou até que a duração mínima tenha expirado, o que for mais longo. (A duração mínima é determinada pela propriedade AutoKeypadTonesMinimumDuration .)

A geração de tom do teclado ocorrerá somente quando o telefone estiver offhook. Se outro tom, como ringback, estiver sendo reproduzido no momento, o tom do teclado interromperá esse tom e o restaurará automaticamente após a conclusão do tom do teclado.

A propriedade AutoKeypadTones funciona somente quando o valor da propriedade PhoneHandlingEnabled é VARIANT_TRUE. Você pode definir a propriedade AutoKeypadTones a qualquer momento. A reconfiguração entrará em vigor na próxima vez que o botão do teclado do telefone for pressionado.