Compartilhar via


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

O método DetectTonesByCollection 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 ao Visual Basic e aos aplicativos de script. Em vez disso, os aplicativos C/C++ devem usar o método DetectTones .

Sintaxe

HRESULT DetectTonesByCollection(
  [in] ITCollection2 *pDetectToneCollection
);

Parâmetros

[in] pDetectToneCollection

Ponteiro para uma interface ITCollection2 que contém uma coleção de ponteiros de interface ITDetectTone que representam os tons a serem monitorados. Cada tom na lista tem um campo de marca definido pelo aplicativo que é usado para identificar os tons individuais quando a detecção de tom é relatada por um evento de TE_TONEEVENT . Para obter mais informações, consulte a seção Comentários a seguir.

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 pDetectToneCollection não é um ponteiro válido.
E_OUTOFMEMORY
Não há memória suficiente para alocar o buffer de tons.
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 DetectTonesByCollection e especifique uma coleção vazia. Para alterar a lista de tons a serem monitorados, chame esse método e especifique uma nova coleção de tons.

Requisitos

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

Confira também

ITCollection2

ITDetectTone

ITLegacyCallMediaControl2