Compartilhar via


Método ITLegacyCallMediaControl2::D etectTones (tapi3if.h)

O método DetectTones habilita e desabilita a detecção de tons de banda na chamada. Sempre que um tom especificado é detectado, uma mensagem é enviada ao aplicativo.

Esse método destina-se a aplicativos C/C++. O Visual Basic e os aplicativos de script devem usar o método DetectTonesByCollection .

Sintaxe

HRESULT DetectTones(
  [in] TAPI_DETECTTONE *pToneList,
  [in] long            lNumTones
);

Parâmetros

[in] pToneList

Ponteiro para uma matriz TAPI_DETECTTONE que especifica os tons a serem detectados. Cada tom na matriz tem um campo de marca definido pelo aplicativo que é usado para identificar os tons individuais na lista quando um evento de detecção de tom do tipo TE_TONEEVENT é relatado. Para obter mais informações, consulte a seção Comentários a seguir.

[in] lNumTones

O número de entradas na matriz especificada pelo parâmetro pToneList . Esse parâmetro será ignorado se pToneList for NULL.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
E_POINTER
O parâmetro pToneList não é um ponteiro válido.
TAPI_E_INVALCALLSTATE
A chamada deve estar no estado conectado .

Comentários

Esse método é convertido em um TAPI 2. xlineMonitorTones call.

Para cancelar o monitoramento de tom em andamento, chame o método DetectTones e especifique um parâmetro pToneListNULL. Para alterar a lista de tons a serem monitorados, chame esse método e especifique uma nova lista de tons.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

ITLegacyCallMediaControl2

TAPI_DETECTTONE