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 |
|---|---|
|
O método foi bem-sucedido. |
|
O parâmetro pDetectToneCollection não é um ponteiro válido. |
|
Não há memória suficiente para alocar o buffer de tons. |
|
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 |