Método ITAutomatedPhoneControl::get_AutoKeypadTones (tapi3if.h)

Artigo
03/02/2024

O método get_AutoKeypadTones obtém 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 get_AutoKeypadTones(
  [out] VARIANT_BOOL *pfEnabled
);

Parâmetros

[out] pfEnabled

VARIANT_TRUE se a geração automática de tom de comentários do teclado telefônico estiver habilitada para este telefone. VARIANT_FALSE se a geração automática de tom de comentários do teclado telefônico estiver desabilitada para este telefone.

Retornar valor

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

Comentários

Se o dispositivo de telefone relatar um botão pressionado como PBS_DOWN, o tom será reproduzido até que o dispositivo de telefone reporte um evento PBS_UP ou até que a duração mínima expire, 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.